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ВВЕДЕНИЕ 


В предыдущем томе "Библиотеки системного программиста" мы научили вас 
устанавливать аппаратное и программное обеспечение для самых распростра¬ 
ненных сетевых операционных систем - Novell NetWare версий 2.2 и 3.11, 
Novell NetWare Lite, а также Microsoft Windows for Workgroups. Надеемся, что 
у вас все получилось и вы имеете возможность работать в сети (а главное, что 
такую возможность имеют все сотрудники вашей организации). 

Следующий этап - программирование для локальных сетей. Под программи¬ 
рованием для локальных сетей понимается составление программ, предназна¬ 
ченных для работы как в составе сетевых операционных систем, так и в составе 
программного обеспечения рабочих станций сети. Сразу отметим, что в этой книге 
мы не будем рассматривать вопросы, связанные с созданием программного 
обеспечения, работающего на файл-серверах Novell NetWare (nlm- и vap- 
программы), а ограничимся лишь сетевым программным обеспечением рабочих 
станций. На первом этапе такое ограничение не играет существенной роли - 
большинство достаточно сложных проблем можно решить в рамках операционных 
систем рабочих станций, не прибегая к программированию в среде Novell NetWare. 

Используя сведения, приведенные в нашей книге, вы сможете решить такие 
задачи, как организация связи между программами, работающими на разных 
станциях в сети без обращения к файл-серверу, создание собственных серверов 
для работы с модемами или базами данных, разработка электронной почты, 
разработка игровых программ для сети и многое другое. 

Что вам понадобится для работы с книгой? 

Во-первых, безусловно, нужна работающая локальная сеть, даже если в ней 
всего два компьютера. Лучше всего, если это будет сеть Novell NetWare версии 
3.11 или 2.2, однако с протоколом IPX вы сможете работать и в сети NetWare Lite, 
причем вам будет достаточно установить сетевые оболочки на рабочие станции. 
Для работы с протоколом IPX или SPX сервер NetWare вообще не нужен! 

Во-вторых, вам потребуется среда разработки программ Borland C++ версии 
3.1 (во всяком случае, все программы, приведенные в книге, отлаживались 
именно в этой среде). При соответствующей адаптации вы сможете воспользо¬ 
ваться Borland C++ версии 3.0 или даже 2.0. Те программы, в которых не 
используется объектно-ориентированный подход, могут с некоторыми мини¬ 
мальными исправлениями транслироваться в среде Microsoft Quick С версии 
2.51 или Microsoft С версии 6.0. 


■ДИАЛОГ-МИФИ" 





Глава 1 

ПЕРЕДАЧА ДАННЫХ В ЛОКАЛЬНОЙ СЕТИ 

В локальной сети данные передаются от одной рабочей станции к другой 
блоками, которые называют пакетами данных. Каждый пакет состоит из заго¬ 
ловка и собственно блока данных. Станция, которая желает передать пакет 
данных другой станции, указывает в заголовке адрес назначения и свой 
собственный, аналогично тому, как это делаете вы, отправляя обычное письмо. 
На конверте, в который вложено письмо, вы указываете адрес получателя и 
обратный (свой собственный) адрес. 

Продолжая аналогию с письмами, вспомним, что на почте существует такая ус¬ 
луга, как отправка письма или телеграммы с уведомлением о вручении. Когда адре¬ 
сат получит ваше письмо, вам отправляется уведомление о вручении. В этом случае 
вы можете убедиться, что письмо дошло до адресата и не потерялось по дороге. 

В локальной сети программы также имеют возможность отправлять 
"обычные письма", а также "письма с уведомлением о вручении". И, разумеется, 
в локальной сети имеется своя система адресов. 

1.1. Датаграммы 

Передача пакетов данных между рабочими станциями без подтверждения - 
это тип связи между рабочими станциями на уровне датаграмм (datagram). Уро¬ 
вень датаграмм соответствует сетевому уровню (Network Layer) семиуровневой 
модели OSI, описанной нами в предыдущем томе. 

Что значит "передача без подтверждения”? Это означает, что не гарантиру¬ 
ется доставка пакета от передающей станции к принимающей. В результате, 
например, перегрузки сети или по каким-либо другим причинам принимающая 
сторона может так и не дождаться предназначенного ей пакета данных. При¬ 
чем, что характерно для уровня датаграмм, передающая сторона так и ке узнает, 
получила ли принимающая сторона пакет или не получила. 

Более того, на уровне датаграмм не гарантируется также, что принимающая 
сторона получит пакеты в той последовательности, в какой они посылаются 
передающей станцией! 

Казалось бы, зачем нужна такая передача данных, которая не гарантирует до¬ 
ставки? Однако программы, обменивающиеся данными, могут сами организо¬ 
вать проверку. Например, принимающая программа может сама посылать под¬ 
тверждение передающей программе о том, что получен пакет данных. 

Протокол передачи данных IPX - межсетевой протокол передачи пакетов 
(Internetwork Packet Exchange) - используется в сетевом программном обеспе¬ 
чении Novell и является реализацией уровня датаграмм. Протокол NETBIOS, 
разработанный фирмой IBM, также может работать на уровне датаграмм. 

Большинство задач в сети можно решить на уровне датаграмм, поэтому мы 
уделим много внимания протоколам IPX и NETBIOS. 


Передача данных в локальной сети 


Одно из преимуществ уровня датаграмм - возможность посылки пакетов дан¬ 
ных одновременно всем станциям в сети. Если же для программ необходима 
гарантированная доставка данных, можно использовать протокол более высоко¬ 
го уровня - уровня сеанса связи. 

1.2. Сеансы связи 

На уровне сеансов связи (Session Layer) две рабочие станции перед началом 
обмена данными устанавливают между собой канал связи - обмениваются паке¬ 
тами специального вида. После этого начинается обмен данными. 

На уровне сеансов связи при необходимости выполняются повторные переда¬ 
чи пакетов данных, которые по каким-либо причинам "не дошли" до адресата. 
Кроме того, гарантируется, что принимающая станция получит пакеты данных 
именно в том порядке, в котором они были переданы. 

При использовании уровня сеансов связи невозможно организовать "широ¬ 
ковещательную" передачу пакетов одновременно всем станциям - для передачи данных 
необходимо организовать канал связи между одной и другой станцией. Следовательно, 
в процессе передачи данных могут участвовать одновременно только две станции. 

Как и следовало ожидать, в сетевом программном обеспечении Novell уро¬ 
вень сеансов связи реализован как надстройка над уровнем датаграмм. На базе 
протокола IPX реализован протокол SPX - протокол последовательной переда¬ 
чи пакетов (Sequenced Packet Exchange Protocol). 

Протокол NETBIOS реализует наряду с уровнем датаграмм уровень сеансов связи. 

В сети Novell NetWare есть эмулятор протокола NETBIOS. Этот эмулятор 
использует протокол IPX для реализации как уровня датаграмм, так и уровня 
сеансов связи. 

13. Сетевой адрес 

Подобно почтовому адресу, сетевой адрес состоит из нескольких компо¬ 
нентов. Это номер сети, адрес станции в сети и идентификатор программы на 
рабочей станции - сокет (рис. 1). 


Куда: 115409, Москва, 
ул. Москворечье, 31, корп. 2 



Кому; АО -Д ИАЛОГ-МИФИ", 1 - 

издательский *■„„ я . „ в -п.ппі9 




111234, Моек, станции шедея 
ул. 1 -я BTopas Кому: сокет 4545 
Иванову И.И. 


Сеть 0034, 

станция 000034532ЕА 
сокет 5665. 


Рис. 1. Сетевой адрес 
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Номер сети (network number) - это номер сегмента сети (кабельного хозяй¬ 
ства), определяемого системным администратором при установке Novell 
NetWare. Не путайте этот номер с внутренним номером сети файл-сервера. 
Напомним, что если в одном сегменте сети имеется два файл-сервера NetWare, 
то они оба имеют одинаковый номер сети, но разные внутренние номера сети. 
Если в общей сети есть мосты, каждая отдельная сеть, подключенная через 
мост, должна иметь свой, уникальный номер сети. 

Адрес станции (node address) - это число, которое является уникальным для 
каждой рабочей станции. При использовании адаптеров Ethernet уникальность 
обеспечивается изготовителем сетевого адаптера (адрес станции записан в мик¬ 
росхеме постоянного запоминающего устройства, которая находится внутри 
самого адаптера). Для адаптеров ArcNet адрес станции необходимо устанавли¬ 
вать при помощи перемычек или переключателей на плате сетевого адаптера. 
Устанавливая в сети адаптеры ArcNet, позаботьтесь о том, чтобы все они имели 
в сети разные адреса. Как установить сетевой адрес адаптера ArcNet, вы сможе¬ 
те узнать из документации, поставляющейся вместе с адаптером. 

Специальный адрес FFFFFFFFFFFFh используется для посылки пакета дан¬ 
ных всем станциям данной сети одновременно. Пакет с таким адресом напоми¬ 
нает открытое письмо с опубликованием в печати. 

Идентификатор программы на рабочей станции - сокет (socket) - число, 
которое используется для адресации конкретной программы, работающей на 
станции. В среде мультизадачных операционных систем, к которым можно от¬ 
нести OS/2 и Microsoft Windows в расширенном режиме, на каждой рабочей 
станции в сети одновременно могут быть запущены несколько программ. 
Для того, чтобы послать данные конкретной программе, используется иден¬ 
тификация программ при помощи сокетов. Каждая программа, желающая 
принимать или передавать данные по сети, должна получить свой, уникальный 
для данной рабочей станции, идентификатор - сокет. 




Глава 2 

ПРОТОКОЛ IPX 

Протокол IPX предоставляет возможность программам, запущенным на рабо¬ 
чих станциях, обмениваться пакетами данных на уровне датаграмм, т. е. без 
подтверждения. 

В сети Novell NetWare наиболее быстрая передача данных при наиболее эко¬ 
номном использовании памяти реализуется именно протоколом IPX. Протоколы 
SPX и NETBIOS сделаны на базе IPX и поэтому требуют дополнительных ре¬ 
сурсов. Поэтому мы начнем изучение программирования для локальных сетей 
именно с протокола IPX. 

Если на рабочей станции используется операционная система MS-DOS, фун¬ 
кции, необходимые для реализации протокола IPX, реализуются резидентными 
программами ipx.com или ipxodi.com, входящими в состав сетевой оболочки 
рабочей станции сети NetWare. 

Для того чтобы научиться составлять программы, которые могут передавать 
данные по сети с использованием протокола IPX, вам необходимо познако¬ 
миться со структурой пакета IPX (вам придется создавать такие пакеты) и на¬ 
учиться пользоваться функциями IPX, реализованными в рамках сетевой обо¬ 
лочки рабочей станции. Вначале мы познакомим вас со структурой пакета IPX, 
затем займемся функциями. 


2.1. Формат пакета IPX 


Формат передаваемых по сети пакетов представлен на рис. 2. 



Checksum - контрольная сумма 
Length - общая длина пакета 
TransportControl - счетчик пройденных мостов 
PacketType - тип пакета 
DestNetwork - номер сети получателя пакета 
DestNode - адрес станции-получателя 
DestSocket - сокет программы-получателя 
SourceNetwork- номер сети отправителя пакета 
SourceNode - адрес станции-отправителя 
SourceSocket - сокет программы-отправителя 
Data - передаваемые данные, от 0 до 546 байт 


Рис. 2. Структура пакета IPX 

Пакет можно разделить на две части - заголовок и передаваемые данные. Все поля, 
представленные на рис. 2, кроме последнего (Data), представляют собой заголовок 
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пакета. Заголовок пакета выполняет ту же роль, что и конверт обычного письма - там 
располагается адрес назначения, обратный адрес и некоторая служебная информация. 

Особенностью формата пакета является то, что все поля заголовка содержат зна¬ 
чения в перевернутом формате, т. е. по младшему адресу записывается старший байт 
данных, а не младший, как это принято в процессорах фирмы Intel. Поэтому перед 
записью значений в многобайтовые поля заголовка необходимо выполнить соот¬ 
ветствующее преобразование. Представление данных в заголовке пакета соответ¬ 
ствует, например, формату целых числел в компьютере ІВМ-370 (серия ЕС ЭВМ). 

Рассмотрим подробнее назначение отдельных полей пакета. 

Поле Checksum предназначено для хранения контрольной суммы передавае¬ 
мых пакетов. При формировании собственных пакетов вам не придется забо¬ 
титься о содержимом этого поля, так как проверка данных по контрольной 
сумме выполняется драйвером сетевого адаптера. 

Поле Length определяет общий размер пакета вместе с заголовком. Длина 
заголовка фиксирована и составляет 30 байт. Размер передаваемых в поле Data 
данных может составлять от 0 до 546 байт, следовательно, в поле Length в зави¬ 
симости от размера поля Data могут находиться значения от 30 до 576 байт. 
Если длина поля Data равна нулю, пакет состоит из одного заголовка. Как это 
ни странно, такие пакеты тоже нужны! При формировании собственных паке¬ 
тов вам не надо проставлять длину пакета в поле Length, протокол IPX сделает 
это сам (вернее, программный модуль, отвечающий за реализацию протокола 
IPX, вычислит длину пакета на основании длины поля Data). 

Поле TransportControl служит как бы счетчиком мостов, которые проходит 
пакет на своем пути от передающей станции к принимающей. Каждый раз, когда 
пакет проходит через мост, значение этого счетчика увеличивается на единицу. 
Перед передачей пакета IPX сбрасывает содержимое этого поля в нуль. Так как 
IPX сам следит за содержимым этого поля, при формировании собственных 
пакетов вам не надо изменять или устанавливать это поле в какое-либо состояние. 

Поле PacketType определяет тип передаваемого пакета. Программа, которая 
передает пакеты средствами IPX, должна установить в поле PacketType значение 4. 
Протокол SPX, реализованный на базе IPX, использует в этом поле значение 5. 

Поле DestNetwork определяет номер сети, в которую передается пакет. При 
формировании собственного пакета вам необходимо заполнить это четырехбай¬ 
товое поле. Напомним, что номер сети задается сетевым администратором при 
установке Novell NetWare на сервер. 

Поле DestNode определяет адрес рабочей станции, которой предназначен па¬ 
кет. Вам необходимо определить все шесть байт этого поля. 

Поле DestSocket предназначено для адресации программы, запущенной на 
рабочей станции, которая должна принять пакет. При формировании пакета 
вам необходимо заполнить это поле. 
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Поля SourceNetwork, SourceNode и SourceSocket содержат соответственно 
номер сети, из которой посьиается пакет, адрес передающей станции и сокет 
программы, передающей пакет. 

Поле Data в пакете IPX содержит передаваемые данные. Как мы уже говорили, 
длина этого поля может быть от 0 до 546 байт. Если длина поля Data равна нулю, 
пакет состоит из одного заголовка. Такой пакет может использоваться программой, 
например, для подтверждения приема пакета с данными. 

Для формирования заголовка пакета можно воспользоваться, например, сле¬ 
дующей структурой: 
struct _IPXHeader { 

unsigned char Checksum! 2]; 
unsigned char Length!2]j 
unsigned char TransportControl; 
unsigned char PacketType; 
unsigned char DestNetwork[4]; 
unsigned char DestNode[6J; 
unsigned char DestSocket[2]; 
unsigned char SourceNetwork[4]j 
unsigned char SourceNode!6]; 
unsigned char SourceSocket!2]; 

> IPXHeader; 

Обращаем ваше внимание на то, что все многобайтовые поля описаны как массивы. 
Даже те, которые состоят из двух байт и могли бы быть описаны как unsigned int Эго 
связано с тем, что все значения в заголовке пакета IPX хранятся в перевернутом виде, 
а для такого типа данных в языке Си нет подходящего описания. 

2.2. Работа с драйвером IPX/SPX 

Первое, что должна сделать программа, желающая работать в сети с прото¬ 
колом IPX или SPX, - проверить, установлен ли драйвер соответствующего про¬ 
токола. Затем необходимо получить адрес вызова этого драйвера - точку входа 
API (Application Programm Interface - интерфейс для приложений). В даль¬ 
нейшем программа вызывает драйвер при помощи команды межсегментного 
вызова процедуры по адресу точки входа API драйвера IPX/SPX. 

2.2.1. Точка входа API драйвера IPX/SPX 

Для того чтобы проверить, загружен ли драйвер IPX, необходимо загрузить в 
регистр АХ значение 7A00h и вызвать мультиплексное прерывание INT 2Fh. 

Если после возврата из прерывания в регистре AL будет значение FFh, драй¬ 
вер IPX загружен. Адрес точки входа для вызова API драйвера при этом будет 
находиться в регистровой паре ES:DI. 

Если же содержимое регистра AL после возврата из прерывания INT 2Fh бу¬ 
дет отлично от FFh, драйвер IPX/SPX не загружен. Это означает, что на данной 
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рабочей станции не загружены резидентные программы ірх.ехе или ipxodi.exe, 
обеспечивающие API для работы с протоколами IPX и SPX. 

Для вызова API в регистр ВХ необходимо загрузить код выполняемой функции. 
Значения, загружаемые в другие регистры, зависят от выполняемой функции. 

Например, функция с кодом 10h используется для проверки присутствия в 
системе протокола SPX (может быть такая ситуация, когда протокол IPX при¬ 
сутствует, a SPX - нет). Для того, чтобы определить наличие SPX, необходимо 
загрузить в ВХ значение 10h, в АХ значение 00h и вызвать API драйвера IPX. 
Если после возврата регистр АХ будет содержать значение FFh, протокол SPX 
присутствует и может быть использован. В регистрах СХ и DX передаются 
параметры SPX - максимальное число каналов связи, которое данная станция 
может установить с программами, работающими на других станциях, и количе¬ 
ство каналов, доступное в настоящее время. О назначении этих параметров мы 
будем говорить в главе, посвященной протоколу SPX. 

Приведем текст программы, определяющей наличие драйвера протоколов IPX 
и SPX (листинг 1). Программа вызывает функции ipx_init() и ipxspx_entryO, 
тексты которых находятся в листинге 2. Текст сокращенного варианта include - 
файла ipx.h представлен в листинге 3. 

Вы можете попробовать запустить эту программу на рабочей станции сети 
Novell NetWare под управлением MS-DOS или на виртуальной машине MS 
Windows, работающей в расширенном (Enchanced) режиме. 

// — --——— --- 

// Листинг 1. Программа для обнаружения драйвера 
// протокола IPX/SPX и определения его версии 
// 

// Файл ірхѵег.с 
// 

// (С) А. Frolov, 1993 

// ---------- 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include “ipx.h" 
void main(void) { 

// Точка входа в IPX/SPX API, переменная находится 

//в файле ipxdrv.asm и инициализируется функцией ipx_init(). 

extern far char *ipxspx_drv_entry; 

// Структура для вызова API IPX 
struct IPXSPX_REGS iregs; 
unsigned error; 

■ unsigned spx_ver; 

unsigned spx_max_connections, spx_avail_connections; 
printf ("\п*Детектор IPX/SPX*, (С) Фролов A., 1993\n\n“); 

// Проверяем наличие драйвера IPX и определяем 
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// адрес точки входа его API 

if(ipx_init( ) == Oxff) printf("IPX загружен! "); 
else { 

printf(“IPX не загружен !\n"); exit(-l); 

> 

printf ("Точка входа в IPX API - %Fp\n",ipxspx_drv_entry); 

// Проверяем доступность протокола SPX 
error = NO_ERRORS; 

// Вызываем функцию проверки доступности SPX 
// Здесь мы вызываем API драйвера IPX/SPX 

iregs.bx = SPX_CMD_INSTALL_CHECK ; 
iregs.ax = 0; 

ipxspx_entry( (void far *)&iregs ); 
if(iregs.ax == 0x00) error = ERR_NO_SPX; 
if(iregs.ax != Oxff) error = UNKNOWN_ERROR; 
if(error I-.NO_ERRORS) { 

printf("SPX не загружен !\n”); exit(-l); 

} 

// Запоминаем параметры IPX/SPX 
spx_ver = iregs.bx; 
spx_max_connections = iregs.cx; 
spx_avail_connections = iregs.dx; 
printf ("SPX загружен! '•); 

printf( "Версия SPX: %d.%d\n", (spx_ver»8) & Oxff, 
spx_ver & Oxff); 

printf( "Всего соединений: %d, ", spx_max_connections); 
printf ("из них доступно: %d\n", spx_avail_connections); 
exit(0); 

> 

Далее расположен исходный текст модуля инициализации IPX (листинг 2). 

В этом модуле находится функция ipxspx_entry(), необходимая для вызова 
драйвера IPX/SPX. Ее имя начинается с символа что необходимо для вы¬ 
полнения соглашения об именах в языке Си. 

Здесь же имеется функция ipxJnitO, которая проверяет наличие драйвера в системе, 
получает адрес API драйвера и сохраняет его в области памяти _ipxspx_drv_entiy. 


; Листинг 2. Инициализация и вызов драйвера IPX/SPX 
; Файл ipxdrv.asm 

; (С) A. Frolov, 1993 


.286 
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} Структура для вызова драйвера IPX/SPX 


IPXSPX_REGS struc 
rax dw ? 

rbx dw ? 

rex dw 7 

rdx dw ? 

rsi dw 7 

rdi dw ? 

res dw 7 

IPXSPX_REGS ends 

■ DATA 

; Точка входа в драйвер IPX/SPX 
_ipxspx_drv_entry dd ? 

PUBLIC _ipxspx_entry, _ipx_init 

PUBLIC _ipxspx_drv_entry 


; Процедура, вызывающая драйвер IPX/SPX 


_ipxspx_entry PROC FAR 

; Готовим BP для адресации параметра функции 
push bp 
mov bp,sp 

; Сохраняем регистры, так как драйвер IPX/SPX 
; изменяет содержимое практически всех регистров 

push d± 

push dx 

push bx 

; Загружаем регистры из структуры, 

; адрес которой передается как параметр 
push ds 

mov bx, [Ьр+6] ; смещение 

mov ds, [bp+8] ; сегмент 

mov es, ds:[bx].res 

mov di, ds:[bx].rdi 

mov si, ds:[bx].rsi 

mov dx, ds:[bx].rdx 

mov cx, ds:[bx].rex 
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mov ax, ds![bx].rax 
mov bx, ds:[bx].rbx 
pop ds 

j Вызываем драйвер IPX/SPX 

call [dword ptr _ipxspx_drv_entry] 

; Сохраняем регистры 
push ds 
push dx 
mov dx, bx 


• Записываем в структуру содержимое регистров после вызова драйвера 
mov bx, [Ьр+6] ; смещение . 

mov ds, [ bp+8 ] ; сегмент 

mov dsi[bx].rax, ax 
mov ds:[bx].rcx, cx 
mov ds:[bx]■rbx, dx 
pop dx 

mov dsi[bx].rdx, dx 


; Восстанавливаем регистры 


pop ax 
pop bx 
pop cx 
pop dx 
pop si 

pop bp 
retf 

_ipxspx_entry ENDP 


; Процедура инициализации драйвера IPX/SPX 


_ipx_init PROC NEAR 
push bp 
mov bp,sp 

; Определяем наличие драйвера в системе и его точку входа 
mov ах, 7a00h 
int 2fh 

; Если драйвера нет, завершаем процедуру 
cmp al, Offh 
jne _ipx_init_exit 


; Сохраняем адрес точки входа 

mov word ptr _ipxspx_drv_entry+2, es 
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mov word ptr _ipxspx_drv_entry, di 
_ipx_init_exits 

; В регистре AX - код завершения процедуры 

pop bp 

_ipx_init ENDP 
end 

Описания типов и констант, а также прототипы функций для программы 
ірхѵег.с находятся в файле ipx.h (листинг 3). 

// Листинг 3. Include -файл для работы с IPX 
// Сокращенный вариант для программы ірхѵег.с 
II Файл ipx.h 
// 

И (С) A. Frolov, 1993 

//--------- 

// --- ... 

// Команды интерфейса IPX 

N - 


♦define IPX_CMD_OPEN_SOCKET 0x00 

♦define IPX_CMD_CLOSE_SOCKET 0x01 

♦define IPX_CMD_GET_LOCAL_TARGET 0x02 

♦define IPX_CMD_SEND_PACKET 0x03 * 

♦define IPX_CMD_LISTEN_FOR_PACKET 0x04 

♦define IPX_CMD_SCHEDOLE_IPX_EVENT 0x05 

♦define IPX_CMD_CANCEL_EVENT 0x06 

♦define IPX_CMD_GET_INTERVAL_MARKER 0x08 

♦define IPX_CMD_GET_INTERNETWORK_ADDRESS 0x09 
♦define IPX_CMD_RELINQUISH_CONTROL 0x0a 

♦define IPX_CMD_DISCONNECT_FROM_TARGET 0x0b 

// - 

// Команды интерфейса SPX 
// — i-- 

♦define SPX_CMD_INSTALL_CHECK 0x10 


// ----- 

// Коды ошибок 

И --—--- 

♦define NO_ERRORS 0 

♦define ERR_NO_IPX 1 

♦define ERR_NO_SPX 2 

♦define NO_LOGGED_ON 3 

♦define ONKNOWN_ERROR 


Oxff 
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И -- 

// Константы 

И ---а-гт!- 

♦define SHORT_LIVED О 

♦define LONG_LXVED Oxff 

♦define IPX_DATA_PACKET_MAXSIZE 546 

// Внешние процедуры для инициализации и вызова драйвера IPX/SPX 
void far ipxspx_entry(void far *ptr); 

int ipx_init(void); 

// Структура для вызова драйвера IPX/SPX 
struct IPXSPX_REGS { 

unsigned int ax; 

unsigned int bx; 

unsigned int cX; 

unsigned int dx; 

unsigned int si; 

unsigned int di; 

unsigned int es; 


2.2.2. Использование API драйвера IPX 

Теперь, после того как мы научились проверять наличие драйвера IPX и оп¬ 
ределять точку входа для вызова его API, нам предстоит научиться пользоваться 
этим API. Без преувеличения можно сказать, что от того, насколько хорошо вы 
освоите API драйвера IPX, зависят ваши успехи в создании программного обе¬ 
спечения для сетей Novell NetWare. 

Однако, прежде чем мы займемся программным интерфейсом IPX, нам необ¬ 
ходимо разобраться со структурой программ, способных обмениваться данными по 
сети, и понять, каким образом программы, работающие на различных станциях, 
моіут передавать друг другу эти самые данные. Такие знания помогут вам и в том 
случае, если вы будете создавать программы, использующие протокол NETBIOS. 

Схема "клиент-сервер" 

Обычно в сети одна из рабочих станций принимает запросы на выполнение 
каких-либо действий от других рабочих станций. Так как станция обслуживает 
запросы, она называется сервером (serve - обслуживать, server - обслуживающее 
устройство). Выполнив запрос, сервер посылает ответ в запросившую станцию, 
которая называется клиентом. 

В сети может быть много серверов и много клиентов. Одни и те же клиенты 
могут посылать запросы разным серверам. 

Говоря более строго, сервером или клиентом является не рабочая станция, а запущенная 
на ней программа В мультизадачной среде разнье программы, запущенные одновременно 
на од ной и той же рабочей станции могут являться и клиентами, и серверами. 
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Программа-сервер, выполнив очередной запрос, переходит в состояние ожи¬ 
дания. Она ждет прихода пакета данных от программы-клиента. В зависимости от 
содержимого этого пакета программа-сервер может выполнять различные действия, 
в соответствии с логикой работы программы. Например, она может принять от 
программы-клиента дополнительные пакеты данных или передать свои пакеты. 

Сервер и клиент при необходимости на какое-то время или навсегда могут 
поменяться местами, изменив свое назначение на противоположное. 

Для того, чтобы создавать программы-серверы и программы-клиенты, нам не¬ 
обходимо научиться выполнять две задачи: 

• инициализацию сервера и клиента; 

• прием и передачу пакетов данных. 

Инициализация сервера и клиента 

Для инициализации программ сервера и клиента, работающих на базе IPX, не¬ 
достаточно убедиться в наличии соответствующего драйвера и получить точку вхо¬ 
да в его API. Вам необходимо вьптолнить некоторые подготовительные действия 
для того, чтобы программа могла принимать и передавать пакеты данных. 

Прежде всего необходимо, чтобы программа-сервер или программа-клиент 
идентифицировали себя в сети при помощи механизма сокетов. 

Для хранения сокета используется двухбайтовое слово, так что диапазон воз¬ 
можных значений простирается от 0 до FFFFh. Однако вы не можете использо¬ 
вать произвольные значения. 

Некоторые значения зарезервированы для использования определенными про¬ 
граммами. Это так называемые "хорошо известные" сокеты ("well-known" sockets). 

Так как протокол IPX является практической реализацией протокола Xerox 
Internetwork Packet Protocol, первоначальное распределение сокетов выполняет¬ 
ся фирмой Xerox. Согласно этому распределению сокеты от 0 до 3000 зарезер¬ 
вированы статически за определенным программным обеспечением. В частно¬ 
сти, фирма Novell получила от фирмы Xerox диапазон сокетов для своей 
сетевой операционной системы NetWare. В спецификации Xerox сокеты со 
значением, большим чем 3000, могут распределяться динамически. 

Динамически распределяемые сокеты выдаются программам как бы во вре¬ 
менное пользование (на время их работы) по специальному запросу. Перед на¬ 
чалом работы программа должна запросить сокет у протокола IPX, а перед 
завершением - освободить его. 

Распределение сокетов в сети Novell NetWare несколько отличается от 
распределения, установленного фирмой Xerox. Сокеты от 0 до 4000h заре¬ 
зервированы и не должны использоваться в программном обеспечении поль¬ 
зователей. Сокеты от 4000h до 8000h распределяются динамически. Диапазон 
"хорошо известных" сокетов, распределяемых Novell персонально раз¬ 
работчикам программного обеспечения, расположен выше значения 8000h. 

Вы, как разработчик программного обеспечения для сетей NetWare, можете 
получить у Novell для своей программы персональный сокет (если сумеете это 
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сделать) или воспользоваться сокетом, полученным динамически. Можно зада¬ 
вать сокет в качестве параметра при запуске программы. Если вы обнаружите, 
что используемое вами значение сокета конфликтует с другим программным 
обеспечением, вы легко сможете изменить его, просто задавая новое значение 
для соответствующего параметра. 

При реализации схемы обмена данными "клиент-сервер" сервер обычно при¬ 
нимает пакеты на сокете, значение которого известно программам-клиентам. 
Сами же программы-клиенты могут использовать либо то же самое значение 
сокета, либо получать свой сокет динамически. Клиент может сообщить серве¬ 
ру свой сокет просто передав его в пакете данных (так как мы предполагаем, 
что сокет сервера известен программе-клиенту). 

После определения сокета необходимо узнать сетевой адрес станций-получате¬ 
лей. Для того чтобы клиент мог послать запрос серверу, необходимо кроме сокета 
сервера знать его сетевой адрес - номер сети и адрес рабочей станции в сети. 

Если программа-клиент знает только сокет программы-сервера, но не знает его 
сетевой адрес, последний можно запросить у сервера, послав запрос во все станции 
одновременно. Такой запрос в пределах одного сегмента сети можно выполнить, 
если в качестве адреса рабочей станции указать специальное значение 
FFFFFFFFFFFFh. Это так называемый "широковещательный" (broadcast) адрес. 

Клиент посылает запрос на известный ему сокет программы-сервера и исполь¬ 
зует адрес FFFFFFFFFFFFh. Такой запрос принимают все программы на всех 
рабочих станциях, ожидающие пакеты на данном сокете. -Получит его и наша 
программа-сервер. А она может определить свой собственный сетевой адрес 
(выполнив вызов соответствующей функции IPX) и послать его клиенту. Адрес же 
клиента программа-сервер может взять из заголовка принятого пакета. 

Разумеется, существует способ определения адреса рабочей станции по име¬ 
ни пользователя, подключившегося на ней к файл-серверу. Это можно сделать 
при помощи API сетевой оболочки рабочей станции (резидентная программа 
netx.exe). Однако этот способ не позволит вам определить адрес станции, на 
которой не выполнено подключение к файл-серверу или не запущена сетевая 
оболочка netx.exe. Пакет, переданный по адресу FFFFFFFFFFFFh, будет принят 
всеми станциями сети даже в том случае, если файл-сервер выключен или его 
вовсе нет. Поэтому способ определения сетевого адреса через запрос по всей 
сети более универсален. 

Прием и передача пакетов данных 

Рассмотрим теперь процедуру приема пакетов данных средствами IPX. 

Прием и передачу пакетов выполняет сетевой адаптер, работающий с использо¬ 
ванием прерываний. Некоторые сетевые адаптеры работают с памятью через канал 
прямого доступа DMA. Прерывание от сетевого адаптера обрабатывает драйвер се¬ 
тевого адаптера. Например, в операционной системе MS-DOS для адаптеров, 
совместимых с адаптером Novell NE2000 в составе Novell NetWare поставляется 
драйвер ne2000.com, реализованный в вцде резидентной программы. 


"ДИАЛОГА 






Локальные 


персональных компьютеров 


Прикладные программы не работают напрямую с драйвером сетевого адапте¬ 
ра. Все свои запросы на прием и передачу пакетов они направляют драйверу 
IPX (программа ірх.ехе или ipxodi.exe), который, в свою очередь, обращается к 
драйверу сетевого адаптера. 

Для приема или передачи пакета прикладная программа должна подготовить 
пакет данных, сформировав его заголовок, и построить так называемый блок 
управления событием ЕСВ (Event Control Block). В блоке ЕСВ задается адрес¬ 
ная информация для передачи пакета, адрес самого передаваемого пакета в 
оперативной памяти и некоторая другая информация. 

Подготовив блок ЕСВ, прикладная программа передает его адрес соответ¬ 
ствующей функции IPX для выполнения операции приема или передачи пакета. 

Функции IPX, принимающие или передающие пакет, не выполняют ожида¬ 
ния завершения операции, а сразу возвращают управление вызвавшей их прог¬ 
рамме. Прием или передача выполняются сетевым адаптером автономно и 
асинхронно по отношению к программе, вызвавшей функцию IPX для передачи 
данных. После того, как операция передачи данных завершилась, в соответ¬ 
ствующем поле блока ЕСВ устанавливается признак. Программа может перио¬ 
дически проверять ЕСВ для обнаружения признака завершения операции. 

Есть и другая возможность. В блоке ЕСВ можно указать адрес процедуры, 
которая будет вызвана при завершении выполнения операции передачи данных. 
Такой способ предпочтительнее, так как прикладная программа не будет тра¬ 
тить время на периодическую проверку блока ЕСВ. 

Формат блока ЕСВ 

Формат блока ЕСВ представлен на рис. 3. 
























Протокол IPX 


10 


Блок ЕСВ состоит из фиксированной части размером 36 байт и массива дес¬ 
крипторов, описывающих отдельные фрагменты передаваемого или принимае¬ 
мого пакета данных. Приведем структуру, которую вы можете использовать для 
описания блока ЕСВ в программах, составленных на языке Си: 


struct ЕСВ { 

void far ‘Link; 

void far (*ESRAddress) (void) ; 

unsigned char InUse; 
unsigned char 
unsigned int 
unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned int 

void far 
unsigned 
} Packet! 2] » 


CCode; 

Socket; 

Connectionld; 

RrestOfWorkspace; 
DriverWorkspace[12]; 
InunAddress[6]; 
FragmentCnt; 

‘Address; 


Рассмотрим назначение отдельных полей блока ЕСВ. 

Поле Link предназначено для организации списков, состоящих из блоков 
ЕСВ. Драйвер IPX использует это поле для объединения переданных ему блоков 
ЕСВ в списки, записывая в него полный адрес в формате [сегментхмещение]. 
После того, как IPX выполнит выданную ему команду и закончит все операции 
над блоком ЕСВ, программа может распоряжаться полем Link по своему усмот¬ 
рению. В частности, она может использовать это поле для организации списков 
или очередей свободных или готовых для чтения блоков ЕСВ. 

Поле ESRAddress содержит полный адрес программного модуля (в формате 
[сегментхмещение]), который получает управление при завершении процесса 
чтения или передачи пакета IPX. Этот модуль называется программой обслужи¬ 
вания события ESR (Event Service Routine). Если ваша программа не использует 
ESR, она должна записать в поле ESRAddress нулевое значение. В этом случае 
о завершении выполнения операции чтения или передачи можно узнать по из¬ 
менению содержимого поля InUse. 

Поле InUse, как мы только что заметили, может служить индикатором за¬ 
вершения операции приема или передачи пакета. Перед тем как вызвать фун¬ 
кцию IPX, программа записывает в поле InUse нулевое значение. Пока опе¬ 
рация передачи данных, связанная с данным ЕСВ, не завершилась, поле InUse 
содержит ненулевые значения: 

FFh ЕСВ используется для передачи пакета данных; 

FEh ЕСВ используется для приема пакета данных, предназначенного прог¬ 
рамме с определенным сокетом; 
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FDh ЕСВ используется функциями асинхронного управления событиями 

AES (Asynchronous Event Sheduler), ЕСВ находится в состоянии ожида¬ 
ния истечения заданного временного интервала; 

FBh пакет данных принят или передан, но ЕСВ находится во внутренней 
очереди IPX в ожидании завершения обработки. 

Функции асинхронного управления AES будут рассмотрены позже. 

Программа может постоянно опрашивать поле InUse, ожидая завершения 
процесса передачи или приема данных. Как только в этом поле окажется нуле¬ 
вое значение, программа может считать, что запрошенная функция выполнена. 
Результат выполнения можно получить в поле CCode. 

Поле CCode после выполнения функции IPX (после того, как в поле InUse 
будет нулевое значение) содержит код результата выполнения. 

Если с данным ЕСВ была связана команда приема пакета, в поле CCode мо¬ 
гут находиться следующие значения: 

00 пакет был принят без ошибок; 

FFh указанный в ЕСВ сокет не был предварительно открыт программой; 

FDh переполнение пакета; либо поле количества фрагментов в пакете 
FragmentCnt равно нулю, либо буферы, описанные дескрипторами 
фрагментов, имеют недостаточный размер для записи принятого пакета; 
FCh запрос на прием данного пакета был отменен специальной функцией 
драйвера IPX. 

Если ЕСВ использовался для передачи пакета, в поле CCode после заверше¬ 
ния передачи могут находиться следующие значения: 

00 пакет был передан без ошибок (что, кстати, не означает, что пакет был 
доставлен по назначению и успешно принят станцией-адресатом, так 
как протокол IPX не обеспечивает гарантированной доставки пакетов); 
FFh пакет невозможно передать физически из-за неисправности в сетевом 
адаптере или в сети; 

FEh пакет невозможно доставить по назначению, так как станция с указан¬ 
ным адресом не существует или неисправна; 

FDh сбойный: либо имеет длину меньше 30 байт, либо первый фрагмент пакета 
по размеру меньше размера стандартного заголовка пакета IPX, либо поле 
количества фрагментов в пакете FragmentCnt равно нулю; 

FCh запрос на передачу данного пакета был отменен специальной функцией 
драйвера IPX. 

Поле Socket содержит номер сокета, связанный с данным ЕСВ. Если ЕСВ 
используется для приема, это поле содержит номер сокета, на котором выпол¬ 
няется прием пакета. Если же ЕСВ используется для передачи, это поле содер¬ 
жит номер сокета передающей программы (но не номер сокета той программы, 
которая должна получить пакет). 



Протокол IPX 


21 


Поле IPXWorkspace зарезервировано для использования драйвером IPX. Ва¬ 
ша программа не должна инициализировать или изменять содержимое этого 
поля, пока обработка ЕСВ не завершена. 

Поле DriverWorkspace зарезервировано для использования драйвером сетевого 
адаптера. Ваша программа не должна инициализировать или изменять содержимое 
этого поля, так же как и поля IPXWorkspace, пока обработка ЕСВ не завершена. 

Поле ImmAddress (Immediate Address - непосредственный адрес) содержит 
адрес узла в сети, в который будет направлен пакет. Если пакет передается в 
пределах одной сети, поле ImmAddress будет содержать адрес станции-получа¬ 
теля (такой же, как и в заголовке пакета IPX). Если же пакет предназначен для 
другой сети и будет проходить через мост, поле ImmAddress будет содержать 
адрес этого моста в сети, из которой передается пакет. 

Поле FragmentCnt содержит количество фрагментов, на которые надо раз¬ 
бить принятый пакет, или из которых надо собрать передаваемый пакет. В про¬ 
стейшем случае весь пакет, состоящий из заголовка и данных, может представ¬ 
лять собой непрерывный массив. Однако часто удобнее хранить отдельно 
данные и заголовок пакета. Механизм фрагментации позволяет вам избежать 
пересылок данных или непроизводительных потерь памяти. Вы можете указать 
отдельные буферы для приема данных и заголовка пакета. Если сами принимае¬ 
мые данные имеют какую-либо структуру, вы можете рассредоточить отдельные 
блоки по соответствующим буферам. 

Значение, записанное вами в поле FragmentCnt, не должно быть равно нулю. 
Если в этом поле записано значение 1, весь пакет вместе с заголовком записы¬ 
вается в один общий буфер. 

Сразу вслед за полем FragmentCnt располагаются дескрипторы фрагментов, 
состоящие из указателя в формате [сегментхмещение] на фрагмент Address и 
поля размера фрагмента Size. 

Если программе надо разбить принятый пакет на несколько частей, Она дол¬ 
жна установить в поле FragmentCnt значение, равное количеству требуемых 
фрагментов. Затем для каждого фрагмента необходимо создать дескриптор, в 
котором указать адрес буфера и размер фрагмента. Аналогичные действия вы¬ 
полняются и при сборке пакета перед передачей из нескольких фрагментов. 

Отметим, что самый первый фрагмент не Должен быть короче 30 байт, так 
как там должен поместиться заголовок пакета IPX. 

2.3. Основные функции API драйвера IPX 

API драйвера протокола IPX состоит из примерно дюжины функций, пред¬ 
назначенных для выполнения операций с сокетами, сетевыми адресами, для 
приема и передачи пакетов и некоторых других операций. В этом разделе мы 
кратко рассмотрим состав и назначение основных функций IPX. 
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2.3.1. Функции для работы с сокетами 

В этом разделе мы опишем функции IPXOpenSocket и IPXCloseSocket, пред¬ 
назначенные для получения и освобождения сокетов. 


IPXOpenSocket 
На входе: ВХ = 
AL = 

DX = 


00h. 

Тип сокета: 

00h - короткоживущий; 

FFh - долгоживущий. 

Запрашиваемый номер сокета или OOOOh, если требуется 
получить динамический номер сокета. 

Примечание. Байты номера сокета находятся в перевер¬ 
нутом виде. 


На выходе: AL = 


DX = 


Код завершения: 

00h - сокет открыт; 

FFh - этот сокет уже был открыт раньше; 
FEh - переполнилась таблица сокетов. 
Присвоенный номер сокета. 


Перед началом передачи пакетов программа должна получить свой иденти¬ 
фикатор - сокет. Функция IPXOpenSocket как раз и предназначена для получе¬ 
ния сокета. 

Сокеты являются ограниченным ресурсом, поэтому программы должны забо¬ 
титься об освобождении сокетов.. Когда вы открываете (запрашиваете у IPX) сокет, 
вы должны указать тип сокета - короткоживущий или долгоживущий. 

Короткоживущие сокеты освобождаются (закрываются) автоматически после 
завершения программы. Долгоживущие сокеты можно закрыть только с по¬ 
мощью специально предназначенной для этого функции IPXCloseSocket. Такие 
сокеты больше всего подходят для использования резидентными программами 
или драйверами. Более того, для резидентных программ, работающих с IPX* вы 
просто обязаны использовать долгоживущие сокеты, так как в противном слу¬ 
чае при завершении программы (и при оставлении ее резидентной в памяти) все 
открытые программой сокеты будут автоматически закрыты. В этом случае 
после активизации резидентная программа останется без сокетов. 

Если вы не используете динамическое распределение сокетов и задаете свой 
номер сокета, используйте значения в диапазоне от 4000h до 8000h или получи¬ 
те персональньш зарегистрированный сокет у фирмы Novell. 

По умолчанию при загрузке оболочки рабочей станции вам доступно макси¬ 
мально 20 сокетов. При соответствующей настройке сетевой оболочки вы мо¬ 
жете увеличить это значение до 150. 
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IPXCloseSocket 
На входе: ВХ = 01 h. 

DX = Номер закрываемого сокета. 

На выходе: Регистры не используются. 

Функция закрывает заданный в регистре DX сокет, короткоживущий или 
долгоживущий. 

Если с закрываемым сокетом связаны ЕСВ, находящиеся в обработке (в со¬ 
стоянии ожидания завершения приема или передачи), указанные ЕСВ освобож¬ 
даются, а ожидающие завершения операции отменяются. При этом в поле InUse 
для таких ЕСВ проставляется нулевое значение, а в поле CCode - значение FCh, 
означающее, что операция была отменена. 

Для отмененных ЕСВ программы ESR не вызываются. 

Функцию IPXCloseSocket нельзя вызывать из программы ESR. 

2.3.2. Функции для работы с сетевыми адресами 

IPXGetLocalTaget 
На входе: ВХ = 02h. 

ES:SI = Указатель на буфер длиной 12 байт, содержащий полный 
сетевой адрес станции, на которую будет послан пакет. 

ES:DI = Указатель на буфер длиной 6 байт, в который будет записан 
непосредственный адрес, т. е. адрес той станции, которой 
будет передан пакет. Это может быть адрес моста. 

На выходе: AL = Код завершения: 

00h - непосредственный адрес был успешно вычислен; 
FAh - непосредственный адрес вычислить невозмож¬ 
но, так как к указанной станции нет ни 
одного пути доступа по сети. 

СХ = Время пересылки пакета до станции назначения (только 
если AL равен нулю) в тиках системного таймера. Тики 
таймера следуют с периодом примерно 1/18 секунды. 

Функция применяется для вычисления значения непосредственного адреса, 
помещаемого в поле ImmAddress блока ЕСВ перед передачей пакета. 

Так как станция-получатель может находиться в другой сети, прежде чем достигнуть 
цели, пакет может пройти один или несколько мостов. Поле непосредственного адреса 
IirmAddress блока ЕСВ должно содержать либо адрес станции назначения (если пе¬ 
редача происходит в пределах одной сети), либо адрес моста (если пакет предназначен 
для рабочей станции, расположенной в другой сети). Используя указанный в буфере 
размером 12 байт полный сетевой адрес, состоящий из номера сети, адреса станции в 
сети и сокета приложения, функция IPXGetLocalTaget вычисляет непосредственный 
адрес, т. е. адрес той станции в данной сети, которая получит передаваемый пакет. 


I 
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Формат полного адреса представлен на рис. 4. 

Network- номер сети 
1 1 Node - адрес станции в сети 

Socket- сокет 
Рис. 4. Формат полного адреса 

Для работы с полным адресом вы можете использовать следующую структуру: 
struct NET_ADDRESS { 

unsigned char Network[4]; 
unsigned char Node[6]; 
unsigned char Socket[2]; 

>! 

В поле Network указывается номер сети, в которой расположена станция, 
принимающая пакет. 

Поле Node должно содержать адрес станции в сети с номером, заданным со¬ 
держимым поля Network. Если пакет должны принять все станции, находящи¬ 
еся в сети Network, в поле Node необходимо записать адрес FFFFFFFFFFFFh. 

Поле Socket адресует конкретную программу, работающую на станции с за¬ 
данным адресом. 

Если программа-сервер принимает пакеты от клиентов и возвращает клиентам 
свои пакеты, нет необходимости пользоваться функцией IPXGetLocalTaget для за¬ 
полнения поля ImmAddress блока ЕСВ перед отправкой ответа станции-клиенту. 
Когда от клиента приходит пакет, в поле ImmAddress блока ЕСВ автоматически 
записывается непосредственный адрес станции (или моста), из которой пришел па¬ 
кет. Поэтому для отправки ответного пакета можно воспользоваться тем же самым 
ЕСВ с уже проставленным значением в поле ImmAddress. 

IPXGetlnternetworkAddress 
На входе: ВХ = 09h. 

ES:DI = Указатель на буфер длиной 10 байт; в него будет запи¬ 
сан адрес станции, на которой работает данная прог¬ 
рамма. Адрес состоит из номера сети Network и адреса 
станции в сети Node. 

На выходе: Регистры не используются. 

С помощью этой функции программа может узнать сетевой адрес станции, на 
которой она сама работает. Полученный адрес программа может затем исполь¬ 
зовать по своему усмотрению (например, сообщить его другой станции). 

Формат буфера аналогичен представленному на рис. 4, за исключением того, 
что в буфер не записывается сокет. Считается, что сокет программа знает, так 
как она его открывала. I 
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На входе: ВХ = 04h. 

ES:DI = Указатель на заполненный блок ЕСВ. Необходимо запол¬ 
нить поля: 

ESRAddress; 

Socket; 

FragmentCnt; 

указатели на буферы фрагментов Address; 
размеры фрагментов Size. 

На выходе: Регистры не используются. 

Эта функция предназначена для инициирования процесса приема пакетов дан¬ 
ных из сети. Она передает драйверу IPX подготовленный блок ЕСВ, и тот 
включает его в свой внутренний список блоков ЕСВ, ожидающих приема пакетов. 
Одновременно программа может подготовить несколько блоков ЕСВ (не¬ 
ограниченное количество) и для каждого вызвать функцию IPXListenForPackets. 

Данная функция сразу возвращает управление вызвавшей ее программе, не 
дожидаясь прихода пакета. Определить момент приема пакета программа может 
либо анализируя поле InUse блока ЕСВ, либо указав перед вызовом функции 
адрес программы ESR (в блоке ЕСВ), которая получит управление сразу после 
прихода пакета. Если программа ESR не используется, в поле ESRAddress дол¬ 
жно быть нулевое значение. 

Сразу после вызова функции IPXListenForPackets в поле InUse блока ЕСВ 
устанавливается значение FEh, которое означает, что для данного блока ЕСВ 
ожидается прием пакета. Как мы уже говорили, программа может ожидать од¬ 
новременно много пакетов. 

Если программа подготовила для приема пакетов несколько блоков ЕСВ, то для 
приема пришедшего пакета будет использован один из подготовленных ЕСВ. 
Однако не гарантируется, что блоки ЕСВ будут использоваться в том порядке, в 
котором они ставятся на ожидание приема функцией IPXListenForPackets. Если 
свободных, ожидающих приема пакета, блоков ЕСВ нет, то приходящий пакет 
будет проигнорирован. Аналогично, если ожидается пакет по данному сокету, а 
сокет не открыт, пришедший пакет также будет проигнорирован. 

После прихода пакета в поле CCode использованного блока ЕСВ драйвер 
IPX записывает код результата приема пакета, а в поле ImmAddress - непосред¬ 
ственный адрес станции, из которой пришел пакет. Если пакет пришел из дру¬ 
гой сети, в этом поле будет стоять адрес моста (адрес моста в той сети, где 
находится принимающая станция). 

1 Затем в поле InUse блока ЕСВ проставляется нулевое значение и вызыва¬ 
ется программа ESR, если ее адрес был задан перед вызовом функции 
IPXListenForPackets. 
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После приема пакета в поле CCode могут находиться следующие значения: 

00 пакет был принят без ошибок; 

FFh указанный в ЕСВ сокет не был предварительно открыт программой; 

FDh переполнение пакета: либо поле количества фрагментов в пакете 
FragmentCnt равно нулю, либо буферы, описанные дескрипторами 
фрагментов, имеют недостаточный размер для записи принятого пакета; 
FCh запрос на прием данного пакета был отменен специальной функцией 
драйвера IPX; 

Функция iPXListenForPackets может использоваться для приема только таких па¬ 
кетов в адресе назначения которых указан сокет, совпадающий с номером сокета, 
подготовленного в блоке ЕСВ. Перед тем, как использовать сокет для приема 
пакетов, его необходимо открыть функцией IPXOpenSocket, описанной выше. 

Если запрос на прием пакета был отменен специальной функцией или в ре¬ 
зультате выполнения функции IPXCloseSoket, поле InUse блока ЕСВ устанавли- 
вается в нулевое значение, однако программа ESR, даже если ее адрес был за- 
дан, не вызывается. В поле CCode проставляется значение FCh. 


Указатель на заполненный блок ЕСВ. Необходимо запол¬ 
нить поля: 

ESRAddress; 

Socket; 

ImmAddress; 

FragmentCnt; 

указатели на буферы фрагментов Address; 
размеры фрагментов Size. 

В заголовке пакета IPX необходимо заполнить поля: 
PacketType; 

DestNetwork; 

DestNode; 

DestSocket. 

Регистры не используются. 

Эта функция подготавливает блок ЕСВ и связанный с ним заголовок пакета 
для передачи пакета по сети. Она сразу возвращает управление вызвавшей ее 
программе, не дожидаясь завершения процесса передачи пакета. Определить 
момент завершения передачи пакета программа может либо анализируя поле 
InUse блока ЕСВ, либо указав перед вызовом функции адрес программы ESR (в 
блоке ЕСВ), которая получит управление сразу после завершения процесса 
передачи пакета. Если программа ESR не используется, в поле ESRAddress 
должно быть нулевое значение. 


IPXSendPacket 
На входе: ВХ = 
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Перед вызовом этой функции вам необходимо заполнить указанные выше 
поля в блоке ЕСВ, подготовить заголовок пакета и, разумеется, сам передавае¬ 
мый пакет. Затем вы вызываете функцию IPXSendPacket, которая ставит блок 
ЕСВ в очередь на передачу. Сама передача пакета происходит асинхронно по 
отношению к вызывавшей ее программе. 

Пакет будет передан в станцию, адрес которой указан в поле ImmAddress. 
Если в этом поле указан адрес моста, пакет будет передан через мост в другую 
сеть. Разумеется, что вы должны кроме непосредственного адреса задать еще и 
номер сети адресата, а также адрес станции в этой сети. Для вычисления не¬ 
посредственного адреса (который надо будет записать в поле ImmAddress) мож¬ 
но воспользоваться описанной выше функцией IPXGetLocalTaget. 

Сразу после вызова функции IPXSendPacket в поле InUse блока ЕСВ уста¬ 
навливается значение FFh. После завершения процесса передачи пакета поле 
InUse принимает значение 00h. Результат выполнения передачи пакета можно 
узнать, если проанализировать поле CCode блока ЕСВ: 

00 пакет был передан без ошибок (что, кстати, не означает, что пакет был 
доставлен по назначению и успешно принят станцией-адресатом, так 
как протокол IPX не обеспечивает гарантированной доставки пакетов); 
FFh пакет невозможно передать физически из-за неисправности в сетевом 
адаптере или в сети; 

FEh пакет невозможно доставить по назначению, так как станция с указан¬ 
ным адресом не существует или неисправна; 

FDh сбойный пакет: либо имеет длину меньше 30 байт, либо первый фрагмент 
пакета по размеру меньше размера стандартного заголовка пакета IPX, 
либо поле количества фрагментов в пакете FragmentCnt равно нулю; 

FCh запрос на передачу данного пакета был отменен специальной функцией 
драйвера IPX. 

Обратим еще раз ваше внимание на то, что, даже если код завершения в по¬ 
ле CCode равен нулю, это не гарантирует успешной доставки пакета адресату. 

Из-за чего пакет может не дойти до адресата? Во-первых, пакет может быть 
потерян в процессе передачи по кабелю. Во-вторых, станция, адрес которой 
указан в заголовке пакета, может не работать или такой станции может вообще 
не быть в указанной сети. В-третьих, станция-адресат может не ожидать пакет 
на указанном сокете. 

Если в поле CCode оказалось значение FEh, это также может произойти по 
трем причинам. Во-первых, если пакет предназначен для другой сети, может 
оказаться так, что невозможно найти мост, который соединял бы эти сети. Во- 
вторых, если пакет предназначен для станции в той же сети, может произойти 
сбой в сетевом адаптере или другом сетевом оборудовании. В-третьих, пакет 
может быть передан станции, на которой не открыт соответствующий сокет или 
нет запросов на прием пакета по данному сокету. 

Одна из интересных особенностей при передаче пакетов заключается в том, 
что вы можете передавать пакеты "сами себе”, т. е. передающая и принимаю- 
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щая программы могут работать на одной и той же станции и использовать один 
и тот же сокет. 

IPXRelinquish Control 
На входе: ВХ = OAh. 

На выходе: Регистры не используются. 

Если ваша программа не использует ESR, она, очевидно, должна в цикле оп¬ 
рашивать поле InUse блока ЕСВ, для которого выполняется ожидание заверше¬ 
ния процесса приема или передачи пакета. Однако для правильной работы 
драйвера IPX в цикл ожидания необходимо вставлять вызов функции 
IPXRelinquishControl. Эта функция выделяет драйверу IPX процессорное время, 
необходимое для его правильной работы. 

2.4. Простая система "клиент-сервер" 

В качестве примера рассмотрим две программы. Первая из них является сер¬ 
вером, вторая - клиентом. 

После запуска сервер ожидает пакет от клиента. В свою очередь, клиент после 
запуска посылает пакет одновременно всем станциям данной сети, поэтому на ка¬ 
кой бы станции ни работал сервер, он обязательно примет пакет от клиента. 

Когда сервер примет пакет от клиента, в поле ImmAddress блока ЕСВ серве¬ 
ра окажется непосредственный адрес клиента. Поэтому сервер сможет ответить 
клиенту индивидуально, по его адресу в текущей сети. 

Клиент, в свою очередь, получив пакет от сервера, сможет узнать его сетевой 
адрес (по содержимому поля ImmAddress блока ЕСВ). Следующий пакет клиент 
отправит серверу используя полученный непосредственный адрес сервера. 

Начиная с этого момента сервер знает адрес клиента, а клиент знает адрес 
сервера. Они могут обмениваться пакетами друг с другом не прибегая к посыл¬ 
ке пакетов по адресу FFFFFFFFFFFFh. 

Исходный текст программы-сервера приведен в листинге 4. 

Вначале с помощью функции ipx_init() сервер проверяет наличие дранвера 
IPX и получает адрес его API. Затем с помощью функции IPXOpenSocketO 
программа открывает короткоживущнй сокет с номером 0x4567. Этот номер мы 
выбрали произвольно из диапазона сокетов, распределяемых динамически. 

Далее программа-сервер подготавливает блок ЕСВ для приема пакета от кли¬ 
ента (RxECB). Сперва весь блок расписывается нулями. Затем заполняются 
поля номера сокета, счетчик фрагментов (всего используются два фрагмента) и 
дескрипторы фрагментов. Первый фрагмент предназначен для заголовка пакета, 
второй - для принятых данных. 

Подготовленный блок ЕСВ ставится в очередь на прием пакета при помощи 
функции IPXListenForPacket(). 

Затем программа в цикле опрашивает содержимое поля InUse блока ЕСВ, 
дожидаясь прихода пакета. В цикл ожидания вставляется вызов функции 
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IPXRelinquishControIO и функция опроса клавиатуры getch(). С помощью пос¬ 
ледней вы можете прервать ожидание, если нажмете на любую клавишу. 

После того, как сервер примет пакет от клиента, содержимое поля данных 
(переданное клиентом в виде текстовой строки, закрытой двоичным нулем) 
будет выведено на консоль. 

Приняв пакет, сервер подготавливает еще один блок ЕСВ для передачи от¬ 
ветного пакета. Фактически сервер будет использовать тот же самый блок ЕСВ, 
что и для приема. Поле непосредственного адреса в блоке ЕСВ уже содержит 
адрес клиента, так как когда драйвер IPX принял пакет, он записал 
фактическое значение непосредственного адреса в соответствующее поле блока 
ЕСВ. Для того, чтобы использовать блок ЕСВ для передачи, нам достаточно 
изменить дескрипторы фрагментов - они должны указывать на заголовок пере¬ 
даваемого пакета и на буфер, содержащий передаваемые данные. 

В качестве передаваемых данных сервер использует буфер TxBuffer с запи¬ 
санной в него текстовой строкой "SERVER *DEMO*". Эта строка будет выве¬ 
дена клиентом на консоль после приема от сервера ответного пакета. 

Подготовив блок ЕСВ для передачи, программа ставит его в очередь на пере¬ 
дачу при помощи функции IPXSendPacket(), после чего закрывает сокет и за¬ 
вершает свою работу. 

//------— ------ 

// Листинг 4. Сервер IPX 

/У 

//Файл ipxserv.c 
// 

У/ (С) A. Frolov, 1993 

и ——-—.....---.......-- 

# Include <stdio.h> 

♦include <stdlib.h> 

♦include <Conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include "ipx.h" 

♦define BUFFER_SIZE 512 
void main(void) { 

// Используем сокет 0x4567 

static unsigned Socket = 0x4567j 
// Этот ЕСВ мы будем использовать и для приема 
// пакетов, и для их передачи, 
struct ЕСВ RxECB ; 

f// Заголовки принимаемых и передаваемых пакетов 
struct IPX_HEADER RxHeader, TxHeader; 
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II Буферы для принимаемых и передаваемых пакетов 
unsigned char RxBuffer[BUFFER_SIZE]; 
unsigned char TxBuffer[BUFFER_SIZE]; 
printf(" \п*Сервер IPX*, (С) Фролов A., 1993\n\n“); 
// Проверяем наличие драйвера IPX и определяем 
// адрес точки входа его API 
if(ipx_init() 1= Oxff) { 

printf("IPX не загружён I\n M ); exit(-1); 

> 

// Открываем сокет, на котором мы будем принимать пакеты 
if(IPXOpenSocket(SHORT_LIVED, SSocket)) { 

printf ( "Ошибка при открытии сокета\п"); 
exit (-1); 

}; 

// Подготавливаем ЕСВ для приема пакета 
memset(SRxECB, 0, sizeof(RxECB )); 

RxECB.Socket = IntSwap(Socket); 

RxECB.Fragmentent = 2; 

RxECB.Packet!0].Address = SRxHeader; 

RxECB.Packet[0).Size = sizeof(RxHeader); 

RxECB.Packet!11.Address = RxBuffer; 

RxECB.Packet[l] .Size = BUFFER_SIZE_; 

IPXLis tenForPacket(SRxECB); 
printf( "Ожидание запроса от клиентаХп"); 
printf ("Для отмены нажмите любую клавишуХп"); 
while(RxECB.InUse) { 

IPXRelinquishControl () ; 
if(kbhit()) { 
getch(); 

RxECB.CCode - Oxfe; 
break; 


if(RxECB.CCode == 0) { 

printf( "Принят запрос от клиента *%s'\n", RxBuffer); 
printf ("Для продолжения нажмите любую клавишуХп"); 
getch(); 

II Подготавливаем ЕСВ для передачи пакета 
II Поле ImmAddress не заполняем, так как там 
// уже находится адрес станции клиента. 

// Это потому, что мы только что приняли от клиента пакет 
// данных и при этом в ЕСВ установился непосредственный адрес 
//станции, которая отправила пакет 

RxECB.Socket = IntSwap ( Socket); 
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RxECB.FragmentCnt =2} 

RxECB.Packet[0].Address = STxHeader; 

RxECB.Packet[0].Size = sizeof(TxHeader); 

RxECB.Packet[l].Address = TxBufferj 
RxECB.Packet[l].Size « BUFFER_SIZE; 

// Подготавливаем заголовок пакета 
TxHeader.PacketType = 4; 
memset(TxHeader.DestNetwork, 0, 4 )} 
memcpy(TxHeader.DestNode, RxECB.ImmAddress, 6); 

TxHeader.DestSocket = IntSwap(Socket); 

// Подготавливаем передаваемые данные 

strcpy(TxBuffer, "SERVER *DEMO*"); 

// Передаем пакет обратно клиенту 
IPXSendPacket ( SRxECB ) j 

> 

// Закрываем сокет 

IPXCloseSocket(ssocket); 
exit(0); 

> 

Программа-клиент (листинг 5) после проверки наличия драйвера IPX/SPX и 
получения адреса его API подготавливает блок ЕСВ и передает первый пакет по 
адресу FFFFFFFFFFFFh. Его принимают все станции в текущей сети, но откли¬ 
кается на него только та станция, на которой запущена программа-сервер. 

Послав первый пакет, клиент подготавливает ЕСВ для приема пакета и ожидает 
ответ от сервера, вызывая в цикле функции IPXRelinquishControl и getchO- После 
прихода ответного пакета клиент закрывает сокет и завершает свою работу.. 

U ----—-- 

// Листинг 5. Клиент IPX 

// 

// Файл ірхсііеп.с 

// 

// (С) А. Frolov, 1993 

//- -- -- 

«include <stdio.h> 

♦include <stdlib.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include “ipx.h" 

// Максимальный размер буфера данных 
♦define BUFFER_SIZE 512 
void main(void) { 
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// Будем работать с сокетом 0x4567 

static unsigned Socket = 0x4567j 
И ECB для приема и передачи пакетов 
struct ЕСВ RxECB , ТхЕСВ; 

// Заголовки принимаемых и передаваемых пакетов 
struct IPX_BEADER RxHeader, TxHeader; 

// Буфера для принимаемых и передаваемых данных 
unsigned char RxBuffer[BDFFER_SIZE] ; 
unsigned char TxBuffer [BDFFER_SIZE]; 
printf(" \п*Клиент IPX*, (С) Фролов A., 1993\n\n"); 

11 Проверяем наличие драйвера IPX и определяем 
1 1 адрес точки входа его API 
if(ipx_init( ) 1- Oxff) { 

printf ( "IPX не загружен !\n"); exit(-l); 

> 

II Открываем сокет, на котором будем принимать и передавать пакеты 
if(IPXOpenSocket(SHORT_LIVED, SSocket)) { 

printf ("Ошибка при открытии сокета\п"); 
exit(-l) ; 

У. 

II Подготавливаем ЕСВ для передачи пакета 
memset(STxECB, 0, sizeof (ТхЕСВ)); 

ТхЕСВ. Socket = IntSwap ( Socket ) ; 

ТхЕСВ. FragmentCnt “ 2j 

TxECB.Packet[0].Address = STxHeader; 

TxECB.PacketIO].Size = sizeof(TxHeader); 

ТхЕСВ. Packet!1].Address = TxBuffer; 

ТхЕСВ. Packet!1].Size = BUFFER_SIZE; 

// Пакет предназначен всем станциям данной сети 
memset (ТхЕСВ. ImmAddress , Oxff, 6); 

// Подготавливаем заголовок пакета 
TxHeader.PacketType = 4; 
memset(TxHeader.DestNetwork, 0, 4); 
memset(TxHeader.DestNode, Oxff, 6); 

TxHeader.DestSocket = IntSwap(Socket)j 
// Записываем передаваемые данные 

strcpy(TxBuffer, "CLIENT *DEMO*"); 

// Передаем пакет всем станциям в данной сети 
IPXSendPacket ( STxECB ); 

II Подготавливаем ЕСВ для приема пакета от сервера 
memset(SRxECB, 0, sizeof(RxECB) ); 
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RxECB.Socket “ Intswap(Socket); 

RxECB.FragmentCnt ” 2; 

RxECB.Packet[0].Address = SRxHeader; 

RxECB.Packet[0].Size = sizeof(RxHeader); 
RxECB.Packet[l].Address = RxBuffer; 

RxECB.Packet[1].Size = BUFFER_SIZ E; 
IPXListenForPacket(SRxECB); 
printf( "Ожидание ответа от сервера\п")г 
printfC'Bnx отмены нажмите любую клавшиу\п" ) ; 
// Ожидаем прихода ответа от сервера 
while(RxECB.InUse) { 

IPXRelinquishControl(); 
if(kbhitO) { 
getch(); 

RxECB.CCode = Oxfe; 
break; 


if(RxECB.CCode == 0) ( 

printf( "Принят ответ от сервера '%s’\n", RxBuffer); 

} 

// Закрываем сохет 

IPXCloseSocket(bSocket); 
exit(0); 

> 

Исходные тексты функций для обращения к API драйвера IPX приведены в 
листинге 5.1. Здесь же определена функция IntSwapO, переставляющая местами 
байты в слове. 

//----——-——- 

/у Листинг 5.1. Функции IPX. 

// 

// Файл ірх.с 

// 

// (С) А. Frolov, 1993 

//--------—--- 

# include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include "ipx.h" 

* .Name Intswap 

* .Title Обмен байтов в слове 


■ДИАЛОГ-МИФИ' 

*-ІО AS 
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* . Descr Функция меняет местами байта в слове, 

* которое передается ей в качестве параметра 

* .Params unsigned i - преобразуемое слово 


* .Return Преобразованное слово 

unsigned IntSwap(unsigned i) { 

return((i»8) I (i s 0xff)«8); 

> 

* .Name IPXOpenSocket 

* .Title Открыть сокет 




Функция открывает сокет, тип которого 
передается ей через параметр SocketType. 

Перед вызовом необходимо подготовить в памяти 
слово и записать в него значение открываемого 
сокета (или нуль, если нужен динамический сокет). 
Адрес слова передается через параметр Socket. 

Если открывается динамический сокет, его 
значение будет записано по адресу Socket. 


int SocketType - тип сокета: 

0x00 - короткоживущий-; 
OxFF - долгоживущий. 


unsigned ‘Socket - указатель на слово, 
в котором находится номер 
открываемого сокета или нуль, 
если нужен динамический сокет. 


* .Return 0 - сокет открыт успешно; 

* OxFE - переполнилась таблица сокетов; 

* OxFF - такой сокет уже открыт. 

**/ 

int IPXOpenSocket(int SocketType, unsigned ‘Socket) { 
struct IPXSPX_REGS iregs; 
iregs.bx = IPX_CMD_OPEN_SOCKET; 
iregs.dx = IntSwap(‘Socket); 
iregs.ax = SocketType; 
ipxspx_entry( (void far *)Siregs ); 

‘Socket » IntSwap(iregs.dx); 
return(iregs.ax); 
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•Name IPXCloseSocket 

.Title Закрыть сокет 

.Descr Функция закрывает сокет. 

Перед вызовом необходимо подготовить в памяти 
слово и записать в него значение закрываемого 
сокета. Адрес слова передается через параметр Socket. 


» .Paraims unsigned ‘Socket - указатель на слово, в котором 
» находится номер закрываемого сокета. 

* .Return Ничего 
“/ 

void IPXCloseSocket(unsigned ‘Socket) { 
struct IPXSPX_REGS iregs; 
iregs.bx = IPX_CMD_CLOSE_SOCKET; 
iregs.dx = IntSwap(‘Socket); 
ipxspx_entry( (void far *)&iregs ); 

} 

* .Name IPXListenForPacket 


* .Title Принять пакет 



функция подготавливает ЕСВ для приема 
пакета из сети. Указатель на ЕСВ передается 
через параметр RxECB. 


* .Params struct ЕСВ ‘RxECB - указатель на ЕСВ, 

* заполненное для приема пакета. 

* .Return Ничего 

void IPXListenForPacket)struct ЕСВ ‘RxECB) { 


struct IPXSPX_REGS iregs; 
iregs.es = FP_6EG((void far‘)RxECB); 
iregs.si = FP_OFF((void far*)RxECB); 
iregs.bx = IPX_CMD_LISTEN_FOR_P АСКЕТ ; 
ipxspx_entry( (void far *)&iregs )| 


* .Name IPXSendPacket 


* .Title Передать пакет 


■диалог-шфи- 
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Функция подготавливает ЕСВ для передачи 
пакета. Указатель на ЕСВ передается через 
параметр ТхЕСВ. 


* .Parents struct ЕСВ *ТхЕСВ - указатель на ЕСВ, 

* заполненное для передачи пакета. 


* .Return Ничего 

void IPXSendPacketfstruct ЕСВ *ТхЕСВ) { 
struct IPXSPX_REGS iregs; 
iregs.es ■> FP_SEG((void far*)TxECB); 
iregs.si - FP_OFF((void far*)TxECB)j 
iregs.bx - IPX_CMD_SEND_PACKET; 
ipxspx_entry( (void far *)&iregs ); 


* .Name IPXRelinquishControl 


* .Title 

* .Descr 


Передать управление IPX при ожидании 
Функция используется при ожидании 

завершения приема через опрос поля ІпПве блока ЕСВ. 
Не используются 


void IPXRelinquishControl(void) { 
struct IPXSPX_REGS iregs; 
iregs.bx = IPX_CMD_RELINQOISH_CONTROL; 
ipxspx_entry( (void far *)&iregs ); 

> 

Листинг 6 содержит include -файл, в котором определены необходимые кон¬ 
станты, структуры данных и прототипы функций. 

// -----— ----■—-———— 

// Листинг 6. Include -файл для работы с IPX 
// Файл ipx.h 
// 

// (С) A. Frolov, 1993 

//---- 

// - - - — 

// Команды интерфейса IPX 
//- 
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«define IPX_CMD_OPEN_SOCKET 0x00 

«define IPX_CMD_CLOSE_SOCKET 0x01 

♦define IPX_CMD_GET_I*OCAL_TARGET 0x02 

«define IPX_CMD_SEND_PACKET 0x03 

♦define IPX_CMD_LISTEN_FOR_PACKET 0x04 

♦define IPX_CMD_SCHEDULE_IPX_EVENT 0x05 

♦define IPX_CMD_CANCEL_EVENT 0 x06 

♦define IPX_CMD_GET_IHTERVAL_MARKER 0x08 

♦define IPX_CMD_GET_INTERNETWORK_ADDRESS 0x09 
♦define IPX_CMD_RELINQOISH_CONTROL 0x0a 

♦define IPX_CMD_DISCONNECT_FROM_TARGET 0x0b 

// - 

// Команды интерфейса SPX 
// - 

♦define SPX_CMD W INSTALL_CHECK 0x10 


// --- 

// Коды ошибок 

// - 

♦define NO_ERRORS 0 

♦define ERR_NO_IPX 1 

♦define ERR_NO_SPX 2 

♦define NO_LOGGED_ON 3 

♦define ONKNOWN_ERROR Oxff 

// - 

// Константы 

// - 

♦define SHORT_LIVED 0 

♦define LONG_LlVED Oxff 

♦define IPX_DATA_PACKET_MAXSIZE 546 

// Внешние процедуры для инициализации и вызова драйвера IPX/SPX 
void far ipxspx_entry(void far *ptr); 

int ipx_init(void); 

// Структура для вызова драйвера IPX/SPX 
struct IPXSPX_REGS { 

unsigned int axj 

unsigned int bx; 

unsigned int cx;' 

unsigned int dx; 

unsigned int si; 

unsigned int di; 

unsigned int es; 

}; 

// ---—-- 

// Заголовок пакета IPX 
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struct IPX_HEADER { 

unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned int 
unsigned char 
unsigned char 
unsigned int 


Checksum; 

Length; 

TransportControl; 
PacketType; 
DestNetwork[4]; 
DestKodef 6]; 
DestSocket; 
SourceNetwork[4]; 
SourceNode[6]; 
SourceSocket; 


// ECB 
struct ECB { 


void far ‘Link; 

void far (‘ESRAddress)(void); 

isigned char InOse; 


unsigned char 
unsigned int 
unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned int 

void far 

unsigned int Size; 
> Packet[2]; 


CCode; 

Socket; 

Connectionld; 

RrestOfWorkspace; 

DriverWorkspace[12]; 
ImmAddress[6]; 
FragmentCnt; 


‘Address; 


unsigned IntSwap(unsigned i); 

int IPXOpenSocket(int SocketType, unsigned ‘Socket); 

void IPXCloseSocket(unsigned ‘Socket); 

void IPXListenForPacket(struct ECB *RxECB); 

void IPXRelinquishControl(void); 

void IPXSendPacket(struct ECB *TxECB); 

2J. Пример с использованием ESR 


В предыдущем примере при ожидании пакета мы опрашивали в цикле поле 
InUse блока ЕСВ. Однако более эффективным является использование прог¬ 
раммы ESR. Эта программа получает управление тогда, когда пакет принят и 
поле InUse установлено в ноль. 

Когда ESR получает управление, регистры процессора содержат следующие 
значения; 
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AL идентификатор вызывающего процесса: 

FFh - программа ESR вызвана драйвером IPX; 

00h - программа ESR вызвана планировщиком асинхронных 
событий AES (будет описан позже); 

ES:SI адрес блока ЕСВ, связанного с данной ESR. 

Содержимое всех регистров, кроме SS и SP, а также флаги процессора запи¬ 
саны в стек программы. 

Если ESR будет обращаться к глобальным переменным программы, необхо¬ 
димо правильно загрузить регистр DS. Непосредственно перед вызовом ESR 
прерывания запрещаются. Функция ESR не возвращает никакого значения и 
должна завершать свою работу командой дальнего возврата RETF. Перед 
возвратом управления прерывания должны быть запрещены. 

Обычно ESR используется для установки ЕСВ, связанных с принятыми паке¬ 
тами, в очередь на обслуживание. Как и всякая программа обработки прерыва¬ 
ния, выполняющаяся в состоянии с запрещенными прерываниями, ESR должна 
выполнять минимально необходимые действия и быстро возвращать управление 
прерванной программе. 

Наша программа -ESR (листинг 8) выполняет простую задачу - записывает адрес 
связанного с ней блока ЕСВ в глобальную переменную completed_ecb_ptr, которая 
сбрасывается в главной программе перед ожиданием приема пакета. Программа- 
клиент (листинг 7), ожидая прихода пакета, выполняет какие-либо действия (в 
нашем случае она просто вводит символы с клавиатуры и выводит их на экран) и 
периодически опрашивает глобальную переменную. Как только пакет будет 
принят, в эту переменную будет записан отличный от нуля адрес блока ЕСВ. 


// Листинг 7. Клиент IPX 
// Файл ірхсііеп.с 
// 

// (С) А. Frolov, 1993 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include <dos.h> 

♦include "ipx.h" 

Максимальный размер буфера данных 
♦define BUFFER_SIZE 512 

extern struct ECB far * completed_ecb_ptr; 
extern void far ipxspx_esr(void)) 


"ДИАЛОГ -A 
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void main(void) { 

// Будем работать о сокетом 0x4567 

static unsigned Socket = 0x4567} 

// ЕСВ для приема и передачи пакетов 
struct ЕСВ RxECB, ТхЕСВ} 

// Заголовки принимаемых и передаваемых пакетов 
struct IPX_HEADER RxHeader, TxHeader} 

//•Буферы для принимаемых и передаваемых данных 
unsigned char RxBuffer[BUFFER_SIZE] ; 
unsigned char TxBuffer[BUFFER_SIZE]; 
printf ( "\п*Клиент IPX*, (С) Фролов A., 1993\n\n''); 

// Проверяем наличие драйвера IPX и определяем 
// адрес точки входа его API 
if(ipx_init( ) !- Oxff) { 

printff'IPX не загружен! \n" )} exit(-l)} 

) 

// Открываем сокет, на котором будем принимать и передавать пакеты 
if ( IPXOpenSocket ( SHORT_LIVED , SSocket) ) { 

printf( "Ошибка при открытии сокета\п")} 
exit(-l) ; 

// Подготавливаем ЕСВ для передачи пакета 
memset ( STxECB , 0, sizeof (ТхЕСВ))} 

ТхЕСВ. Socket = IntSwap ( Socket); 

ТхЕСВ. FragmentCnt =2; 

ТхЕСВ. Packet[0].Address = STxHeader} 

ТхЕСВ. Packet[0).Size = sizeof(TxHeader); 

ТхЕСВ. Packet[1].Address = TxBuffer; 

TxECB.Packet[l].Size = BUFFER_SIZE} 

// Пакет предназначен всем станциям данной сети 
memset( ТхЕСВ. immAddress, Oxff, 6); 

// Подготавливаем заголовок пакета 
TxHeader.PacketType = 4; 
memset ( TxHeader.DestNetwork, 0, 4); 
memset(TxHeader.DestNode, Oxff, 6); 

TxHeader-DestSocket = IntSwap(Socket); 

// Записываем передаваемые данные 

strcpyfTxBuffer, "ESR/CLIENT *DEMO*")} 

// Передаем пакет всем станциям в данной сети 
IPXSendPacket ( STxECB ); 
completed_ecb_ptr = (unsigned long)0; 
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1 1 Подготавливаем ECB для приема пакета от сервера 
memset(&RxECB, 0, sizeof(RxECB )); 

RxECB.Socket = IntSwap(Socket); 

RxECB.FragmentCnt = 2; 

RxECB.Packet[0].Address = SRxHeader; 

RxECB.Packet[0].Size = sizeof(RxHeader); 

RxECB.Packet!1].Address = RxBuffer; 

RxECB.Packet!1]■Size = BUFFER_SIZ E; 

RxECB.ESRAddress = ipxspx_esr; 

IPXListenForPacket(SRxECB); 

printf( "Ожидание ответа от сервера\п")} 

printf ("Нажимайте любые клавиши\п"); 

printf ("Для отмены нажмите клавишу <ESC* *\n"); 

// Ожидаем прихода ответа от сервера 

while(completed_ecb_ptr == NOLL) { 
if( getche() ==27) { 

IPXCloseSocket(sSocket); 
exit(O )t 

> 

} 

if (RxECB. CCode == 0) -{ 

printf ("\пПринят ответ от сервера '%s'\n" , RxBuffer); 

} 

II Закрываем сокет 

IPXCloseSocketf SSocket); 
exit(0); 

> 

В листинге 8 приведен текст программы ESR, составленный на языке ассемблера. 
Программа загружает регистр DS адресом сегмента данных программы, затем 
записывает в глобальную переменную completed_ecb_ptr содержимое регистров ES:SI. 


і Листинг 8. Программа ESR 
; Файл esr.asm 

; (С) A. Frolov, 1992 


.286 

•MODEL SMALL 
.DATA 

_completed_ecb_ptr dd 0 

• CODE 

PUBLIC _ipxspx_esr 

PUBLIC _completed_ecb_ptr 


- ДИАЛОГ-МИФИ " 








42 


Локальные 


персональных компьютеров 


_ipxspx_esr PROC FAR 

mov ax, DGROOP 

mov ds, ax 

mov word ptr _completed_ecb_ptr+2, es 

mov Word ptr _completed_ecb_ptr, si 

retf 

_ipxspx_esr ENDP 

2.6. Другие функции IPX и AES 

Для разработки большинства сетевых программ, ориентированных на переда¬ 
чу данных с использованием протокола IPX, вполне достаточно описанных вы¬ 
ше функций. Однако для полноты картины опишем остальные функции, име¬ 
ющие отношение к протоколу IPX. 

Мы рассмотрим также функции асинхронного планировщика событий AES 
(Asynchronous Event Scheduer), выполняющегося как процесс внутри драйвера IPX. 

2.6.1. Еще одна функция IPX 

IPXDisconnectFrom Taget 

На входе: ВХ = OBh. 

ES:SI = Указатель на структуру, содержащую сетевой адрес станции: 
struct NetworkAddress { 

unsigned char Network[4J; . 

unsigned char Node[6]; 

unsigned char Socket[2]; 

>! , 
На выходе: Регистры не используются. 

Эта функция используется программой для того, чтобы сообщить сетевому ком¬ 
муникационному драйверу, что она (программа) больше не будет посылать пакеты 
на указанную станцию. Соответствующий драйвер освобождает виртуальньш канал 
на уровне платы сетевого адаптера для указанного сетевого адреса. 

Функцию IPXDisconnectFromTaget нельзя вызывать из программы ESR. 

2.6.2. Функции AES 

Если вашей программе требуется измерять временные интервалы, она может 
воспользоваться асинхронным планировщиком событий AES, реализованным 
в рамках драйвера IPX. 

Для функций AES можно использовать тот же формат ЕСВ, что и для фун¬ 
кций IPX. Однако поля используются немного по-другому: 
struct AES_ECB { 

void far* Link; 
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void (far *ESRAddress) ( ) ; 
unsigned char InUse; 
unsigned char AESWorkspace[ 5]; 

}} 

Поле AESWorkspace используется планировщиком AES. Назначение осталь¬ 
ных полей полностью аналогично соответствующим полям обычного ЕСВ. 

IPXSchedulelPXEvent 
На входе: ВХ = 05h. 

АХ = Время задержки в тиках таймера. 

ES:SI = Указатель на блок ЕСВ. 

На выходе: Регистры не используются. 

Функция IPXSchedulelPXEvent немедленно возвращает управление вызвавшей ее 
программе. После истечения временного интервала, заданного в регистре АХ, поле 
InUse блока ЕСВ, адрес которого задавался при вызове этой функции, сбрасывается в 
ноль. После этого вызывается программа ESR, если она была задана для данного ЕСВ. 

Обычно функция IPXSchedulelPXEvent используется внутри ESR, для того 
чтобы отложить на некоторое время обработку принятого пакета. 

IPXGellntervalMarker 
На входе: ВХ = 08h. 

На выходе: АХ = Интервальный маркер. 

Эта функция может использоваться для измерения временных интервалов в 
пределах примерно одного часа. 

Возвращаемое значение - интервальный маркер - это значение, лежащее в 
интервале от OOOOh до FFFFh и представляющее собой время в тиках таймера 
(следуют с интервалом примерно 1/18 секунды). 

Для того, чтобы измерить время между двумя событиями, программа вызывает 
функцию IPXGetlntervalMarker два раза. Разность между полученными значени¬ 
ями является интервалом между событиями в тиках таймера. 

Отметим, что вместо использования этой функции можно опрашивать значение 
двойного слова в области данных BIOS по адресу OOOOh :046Ch. В этом слове хранится 
счетчик тиков таймера, значение которого обновляется каждые 55 миллисекунд. 

IPXCancelEvent 
На входе: ВХ = 06h. 

ES:SI = Указатель на блок ЕСВ. 

На выходе: AL = Код завершения: 

00h - функция выполнена без ошибок; 

F9h - обработка ЕСВ не может быть отменена; 

FFh - указанный ЕСВ не используется. 
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Функция отменяет ожидание события, связанное с указанным блоком ЕСВ. С по¬ 
мощью этой функции можно отменить ожидание приема или передачи пакета, ожи¬ 
дание временного интервала, управляемого AES, или ожидание приема пакета SPX. 

После отмены ЕСВ поле CCode в нем устанавливается в соответствующее со¬ 
стояние, поле InUse устанавливается в нуль. Для отмененного ЕСВ программа 
ESR не вызывается. 

IPX Relinquish Control 
На входе: ВХ = OAh. 

На выходе: Регистры не используются. 

Мы уже описывали эту функцию, предназначенную для выделения драйверу 
IPX процессорного времени, необходимого для его правильной работы. Приве¬ 
дем здесь ее еще раз, так как она по своему функциональному назначению от¬ 
носится к функциям асинхронного планировщика событий AES. 

2,7. Определение топологии сети 

Если средствами IPX или SPX необходимо передавать данные между рабочими 
станциями, расположенными в разных сетях, соединенных мостами, вам не обой¬ 
тись без определения топологии сети. Когда программа передает данные в пределах 
одной сети, она должна знать адрес станции, которой будет посылаться пакет. 
В качестве номера сети можно указать нуль, при этом вам не надо будет даже 
знать номер сети, в которой расположена принимающая станция. Мы уже 
приводили примеры программ, передающих данные в пределах одной сети. 

Другое дело, если в передачу данных вовлекается мост. Если пакет должен пройти 
мост, в поле ImmAddress блока ЕСВ необходимо указать сетевой адрес моста, так как 
для того, чтобы попасть в другую сеть, пакет должен быть передан прежде всего в 
мост. В заголовке пакета при этом должен быть указан адрес принимающей станции - 
ее сетевой адрес, в том числе и номер сети, в которой расположена станция. 

Вспомним, каким образом в приведенных ранее примерах программа-клиент 
и программа-сервер узнавали сетевой адрес друг друга. 

Программа-клиент знала номер сокета, который используется программой- 
сервером. Клиент посылал пакет на этот сокет, при этом в качестве номера 
сети использовалось нулевое значение (пакет предназначен для передачи в пре¬ 
делах той сети, в которой находится передающая станция), а в качестве сетево¬ 
го адреса станции - значение FFFFFFFFFFFFh (пакет предназначен для всех 
станций в сети). Сервер, расположенный в той же сети, что и клиент, принимал 
такой пакет. Анализируя поле "обратного адреса" пакета, сервер мог опреде¬ 
лить точный сетевой адрес клиента. Более того, в поле ImmAddress блока ЕСВ, 
использовавшегося для приема пакета, стоял непосредственный адрес станции, 
от которой пришел пакет (пакет мог прийти и из другой сети через мост, в 
этом случае в поле ImmAddress стоял бы адрес моста). 
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Узнав сетевой адрес клиента, сервер отправлял ему пакет. Приняв пакет от 
сервера, клиент мог определить сетевой адрес сервера из заголовка пришедшего к 
нему пакета. Поле ImmAddress блока ЕСВ, использовавшегося при приеме пакета 
от сервера, содержало непосредственный адрес станции, от которой пришел пакет. 

Если сервер и клиент расположены в разных сетях, ситуация сильно услож¬ 
няется. Если клиент будет посылать пакет по адресу FFFFFFFFFFFFh, указав 
нулевой номер сети, пакет будет принят только теми станциями, которые 
расположены в той же сети, что и передающая станция. Через мост такой пакет 
не пройдет, поэтому если программа-сервер работает на станции, которая нахо¬ 
дится в другой сети, она не получит пакет от клиента. 

Для того, чтобы пакет был принят всеми станциями сети, подключенной че¬ 
рез мост, вам необходимо послать этот пакет в мост, указав в заголовке пакета 
номер сети, в которую передается пакет, а также адрес станции, равный 
FFFFFFFFFFFFh. Для того, чтобы послать пакет в мост, в поле ImmAddress со¬ 
ответствующего блока ЕСВ надо указать адрес моста. 

Следовательно, для того чтобы установить связь с сервером, программа-клиент 
должна узнать номер сети, в которой расположен сервер, и сетевой адрес моста, 
через который можно послать пакет в эту сеть. К сожалению, ни одна из функций 
драйвера IPX или SPX не возвращает информации о конфигурации сети, поэтому 
ваша программа должна уметь получать такую информацию самостоятельно. 

Но вы сможете выяснить конфигурацию сети, если воспользуетесь специаль¬ 
ным диагностическим сервисом, реализованным в рамках драйверов протоко¬ 
лов IPX и SPX. 

Сетевая оболочка, запущенная на рабочих станциях в сети Novell NetWare, 
может принимать пакеты на специальном диагностическом сокете с номером 
0456h. В ответ на принятый пакет диагностический сервис возвращает станции, 
пославшей такой пакет, информацию о конфигурации сетевого программного и 
аппаратного обеспечения станции. 

Основная идея определения конфигурации сети заключается в том, что прог¬ 
рамма-клиент посылает запрос о конфигурации одновременно всем станциям 
данной сети на сокете 0456h, указав в качестве номера сети нуль, а в качестве 
адреса станции значение FFFFFFFFFFFFh. Анализируя приходящую от станций 
диагностическую информацию, программа-клиент может обнаружить в сети 
мосты и определить как номера подключенных к мостам сетей, так и сетевые 
адреса самих мостов. 

Зная сетевой адрес мостов и номера подключенных к ним сетей, программа- 
клиент сможет посылать запросы для поиска программы-сервера во все под¬ 
ключенные к мостам сети. 

Очевидно, можно посылать диагностические запросы на сокете 0456h и в 
другие сети с целью поиска имеющихся там мостов. Таким образом можно 
выяснить конфигурацию всей сети и установить связь с программой-сервером, 
где бы она ни находилась. 


■ДИАЛОГ-МИФИ- 
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Драйверы протоколов IPX и SPX обеспечивают два вида диагностического сер¬ 
виса: IPX -диагностику и SPX -диагностику. Для определения конфигурации сети 
нужна только ІРХ-диагностика. SPX -диагностика предназначена в основном для 
измерений производительности сети и для получения уточненной информации о 
составе и конфигурации программного обеспечения рабочих станций. Подробное 
рассмотрение SPX -диагностики выходит за рамки нашей книги. 

2.7.1. Диагностический сервис IPX 

Программа может посылать диагностические запросы либо конкретной стан¬ 
ции в сети, либо всем станциям, либо всем станциям, за исключением перечис¬ 
ленных в списке. 

Для посылки диагностического запроса программа должна подготовить ІРХ- 
пакет, состоящий из обычного заголовка размером 30 байт и блока данных, 
имеющего следующую структуру: 
struct _REQ { 

unsigned char Exclusions; 
unsigned char List[80][6]; 

}; 

Заголовок пакета подготавливается обычным образом. В качестве номера сети 
можно указывать либо действительный номер сети, либо нулевое значение. 
В качестве сетевого адреса можно указывать либо адрес конкретной станции, либо 
адрес FFFFFFFFFFFFh . В поле сокета необходимо проставить значение 0456h. 

В поле Exclusions блока данных необходимо проставить количество станций, 
от которых не требуется получать диагностику. Адреса таких станций должны 
быть перечислены в массиве List. Если вам надо получить диагностику от всех 
станций, укажите в поле Exclusions нулевое значение. В любом случае, если 
диагностика должна быть получена от нескольких станций, в качестве адреса в 
заголовке пакета необходимо указывать значение FFFFFFFFFFFFh. 

Блок ЕСВ для передачи диагностического запроса также подготавливается обыч¬ 
ным образом. При первом диагностическом запросе в поле ImmAddress указывает¬ 
ся значение FFFFFFFFFFFFh. В дальнейшем при определении конфигурации сети, 
подключенной через мост, в этом поле вы будете указывать сетевой адрес моста. 

Важное замечание относительно сокета 0456h: вы не должны открывать 
или закрывать этот сокет. Диагностический сокет уже открыт, вы должны 
использовать его для формирования адреса при передаче диагностического 
запроса. Для приема ответных пакетов конфигурации (а также для передачи 
запроса) вам следует динамически получить от драйвера IPX другой сокет. 

После приема диагностического пакета каждая станция отвечает на него посыл¬ 
кой пакета конфигурации. Все эти пакеты посылаются с небольшой задержкой 
(примерно полсекунды), значение которой зависит от последнего байта сетевого 
адреса станции. Задержка используется для исключения перегрузки сети пакетами 
конфигурации, посылаемой одновременно многими станциями. 
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Послав диагностический пакет всем станциям, ваша программа получит нес¬ 
колько пакетов конфигурации, поэтому она должна заранее (перед посылкой 
диагностического пакета) зарезервировать достаточное количество блоков ЕСВ 
и буферов для приема пакетов конфигурации. 

Принятый пакет конфигурации состоит из стандартного заголовка ІРХ-пакета 
и блока данных. Принятый блок данных состоит из двух частей. Первая часть 
имеет фиксированную структуру, структура второй части зависит от конфигу¬ 
рации программного и аппаратного обеспечения станции, от которой пришел 
пакет конфигурации. 

Приведем структуру первой части: 
struct „RESPONSE { 

unsigned char MajorVersionj 
unsigned char MlnorVersion; 
unsigned SPXDiagnosticSocket; 
unsigned char ComponentCount; 

>; 

В полях MajorVersion и MinorVersion находится соответственно верхний и 
нижний номер версии диагностического сервиса. 

Поле SPXDiagnosticSocket содержит номер сокета, который должен быть 
использован для SPX -диагностики. 

Самое интересное поле - ComponentCount. В нем находится количество 
компонентов программного и аппаратного обеспечения, информация о которых 
имеется в принятом пакете конфигурации. 

Далее в принятом пакете сразу за полем ComponentCount следуют структуры, опи¬ 
сывающие отдельные компоненты. Они могут быть двух типов - простые и расши¬ 
ренные. Первое поле размером в один байт имеет одинаковое значение в обоих типах 
структур - это идентификатор компонента. По идентификатору компонента можно 
однозначно судить о том, какая используется структура - простая или расширенная. 

Простая структура и в самом деле несложна. Она состоит всего из одного 
байта идентификатора компонента: 


struct _SlHPLE_COMPONENT { 


unsigned char ComponentID; 

У» . 

Значениями поля ComponentID для простой структуры могут быть числа 0,1,. 
2, 3 или 4: 

Значение поля ComponentID 

Компонент 

0 

Драйвер IPX/SPX 

1 

Драйвер программного обеспечения моста 

2 

Драйвер сетевой оболочки рабочей станции 

3 

Сетевая оболочка 

4 

Сетевая оболочка в виде ѴАР-процесса 


•ДИАЛОГ-МИФИ- 
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Расширенная структура сама по себе состоит из двух частей, имеющих соот¬ 
ветственно, фиксированную и переменную структуру. 

Приведем формат фиксированной части: 
struct _EXTENDED_COMPONENT { 

unsigned char ComponentlD; 
unsigned char NumberOfLocalNetworks; 


Поле ComponentlD может содержать значения 5, 6 или 7: 


Значение поля ComponentlD 

Компонент 

5 

Внешний мост 

6 

Файл-сервер с внутренним мостом 

7 

Невыделенный файл-сервер 


Для определения конфигурации сети важно исследовать компоненты с типом 5, 
6 и 7, так как именно они имеют отношение к соединениям сетей через мосты. 

Переменная часть описывает сети, подключенные к компонентам с типом 5, 
6 или 7. Количество таких сетей находится в поле NumberOfLocalNetworks 
фиксированной части. 

Для описания сетей используется массив структур (размерностью 
NumberOfLocalNetworks): 

struct _NETWORK_COMPONENT { 

unsigned char NetworkType; 
unsigned char NetworkAddress[4]; 
unsigned char NodeAddress[6]; 

У. 

Поле NetworkType описывает тип сети: 


Содержимое поля Тип сети 
NetworkType 

О Сеть, к которой подключен сетевой адаптер 

1 Сеть с виртуальным сетевым адаптером (невьщеленный файл-сервер) 

2 Переназначенная удаленная линия (связь сетей через модемы) 

Поле NetworkAddress содержит номер сети, к которой подключен соответ¬ 
ствующий адаптер, а поле NodeAddress - сетевой адрес адаптера. Именно эти 
поля вам и нужны для определения номеров сетей, подключенных к мостам, и 
сетевых адресов самих мостов. 

2.7.2. Пример программы 

Приведем пример программы, которая демонстрирует способ определения 
конфигурации текущей сети, т. е. той сети, в которой работает данная прог¬ 
рамма. Программа создает 20 блоков ЕСВ для приема пакетов конфигурации от 
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рабочих станций, ставит их в очередь на прием пакетов и посылает диагности¬ 
ческий пакет в текущую сеть по адресу FFFFFFFFFFFFh. Затем после неболь¬ 
шой задержки программа анализирует блоки EGB, поставленные в очередь на 
прием. Если был принят пакет конфигурации, он расшифровывается и в тек¬ 
стовом виде выводится в стандартный выходной поток. 

Приводимая ниже программа - первая программа в серии "Библиотека 
системного программиста", составленная на языке C++. В ней мы использовали 
только некоторые возможности языка C++. Для более глубокого понимания 
объектно-ориентированного подхода в программировании вам необходимо озна¬ 
комиться с литературой, список которой приведен в конце книги. 

В функции шаіп() создается объект класса IPX_CLIENT, который по своим 
функциям является клиентом. В нашем случае задача клиента - послать диагно¬ 
стический запрос всем станциям сети и получить от них пакет конфигурации. 
Можно считать, что программа диагностики, работающая на каждой станции, 
является сервером. Принимая запросы от клиентов на диагностическом сокете, 
она посылает им в ответ пакеты конфигурации. 

При создании объекта класса IPX_CLIENT вызывается конструктор, выпол¬ 
няющий все необходимые инициализирующие действия. Конструктор инициа¬ 
лизирует драйвер IPX, получает его точку входа и открывает динамический 
сокет. Соответствующий деструктор автоматически закрывает полученный со¬ 
кет при завершении работы программы. 

Описание класса IPX_CLIENT находится в файле ipx.hpp (см. ниже). 

После того как отработает конструктор объекта IPX_CLIENT, для созданного объ¬ 
екта вызывается функция goO, которая и выполняет все необходимые действия. В теле 
функции определен массив ЕСВ *RxECB[20] из 20 указателей на объекты класса 
ЕСВ. Эти объекты используются для приема пакетов конфигурации. Кроме того, 
определен один объект ЕСВ ТхЕСВ для посылки пакета с диагностическим запросом. 

Программа в цикле создает 20 объектов класса ЕСВ и с помощью функции 
ListenForPacketO ставит их в очередь на прием пакетов. Затем программа посы¬ 
лает в сеть пакет с диагностическим запросом и ждет одну секунду. За это вре¬ 
мя станции сети присылают пакеты конфигурации. 

Полученные пакеты конфигурации выводятся в стандартный поток функцией 
PrintDiagnosticsO, определенной в классе ЕСВ. Эта функция выводит для каж¬ 
дой ответившей станции версию используемой диагностики, номер сокета для 
работы с SPX -диагностикой (не описана в нашей книге), количество програм¬ 
мных компонентов, работающих на станции, номер сети и сетевой адрес 
станции (узла). Для файл-серверов и мостов дополнительно выводится 
количество подключенных к ним сетей. Для каждой сети выводится ее номер и 
сетевой адрес соответствующего адаптера. 

Для упрощения программы мы ограничились диагностикой только одной се¬ 
ти. Кроме того, мы послали только один диагностический запрос, в котором не 
исключали ни одной станции. Если вам нужно определить конфигурацию всей 
сети, вам надо сделать следующее. 


■ДИАЛОГ-МИФИ' 
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Во-первых, после приема пакетов конфигурации запишите адреса ответивших 
станций в список станций, исключаемых из диагностического запроса. Не забудьте 
проставить количество исключаемых станций. Затем выполните повторную 
передачу диагностического запроса. Выполняйте описанную процедуру до тех пор, 
пока в ответ на диагностический запрос не будет передан ни один пакет конфигу¬ 
рации. В этом случае адреса всех станций, имеющихся в текущей сети, будут 
записаны в список станций, исключаемых из диагностического запроса. 

Во-вторых, выполните анализ пришедших пакетов конфигурации. Найдите 
пакеты, которые пришли от файл-серверов и мостов. Определите номеру сетей, 
подключенных к ним. Затем выполните предыдущую процедуру многократной 
посылки диагностических пакетов в остальные сети. Для этого при передаче 
диагностического пакета в заголовке укажите номер сети, которую вы желаете 
проверить. В качестве сетевого адреса станции используйте значение 
FFFFFFFFFFFFh. В блоке ЕСВ в поле непосредственного адреса укажите сете¬ 
вой адрес моста, через который можно получить доступ в исследуемую сеть. 

А теперь приведем текст основной программы (листинг 9): 

И Листинг 9. Вызов диагностики и определение 
// конфигурации текущей сети 

// 

// Файл ipxdiagn.cpp 

И 

U (С) A. Frolov, 1993 

//--- =========== - ========== 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <Btring.h> > 

♦include "ipx.hpp" 

// Вход в программу. 

// Создаем объект - программу-клиент. Затем запускаем ее. 
void main(void) { 

IPX_CLIENT NetView; 

NetView.Go(); 

> ■••■■■■■•» 

// Функция определяет и распечатывает конфигурацию текущей сети. 
void IPX_CLIENT: ! Go(void) { 

// Создаем 20 ЕСВ для приема ответов от станций 
ЕСВ *RxECB[20); 

И Создаем ЕСВ для передачи диагностического запроса. 

ЕСВ TxECB(this->Socket, 0x456); 

// Ставим заказанные ЕСВ в очередь на прием пакетов. 
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for(int i“0; i<20; i++) { 

RxECB[i] - new ECB(this->Socket); 

RxECB i i] ->Lis tenFor Packet ( )I 

) 

// Посылаем диагностический пакет всем станциям текущей сети. 
ТхЕСВ . SendPacket ( ); 

printf ( " "NetView* vl.O, (С) Фролов А.В., 1993\п" 
"Подождите немного...\п\п ") і 
// Ждем примерно одну секунду 
8Іеер( 1 ); 

// Распечатываем конфигурацию сети 

printf ( “Конфигурация сети: \п\п") ; 

printf ( "Версиях tCoxeT\tKoMnoHeHTH\tCeTb\t\tysen\n" ); 

printf ( "- \t — \t- \t-\t\t--\n" ); 

for(i“0j i<20; І++) { 

RxECB[i] ->PrintDiagnostics ()} 


Файл ipx.hpp содержит определения классов для приведенной выше прог¬ 
раммы (листинг 10): 

// ...-—-.......—...—.................... 

// Листинг 10. Include -файп для работы с IPX 
// Файл ipx.hpp 
// 

// (С) A. Frolov, 1993 

// .....,..===..====.=...=======.== - --- 

# include <raem.h> 

♦include <dos.h> 

// - 

// Команды интерфейса IPX 
U --- 


♦define IPX_CMD_OPEN_SOCX£T 0x00 
♦define IPX_CMD„CLOSE_SOCKET 0x01 
♦define IPX_CMD_GET_LOCAL_TARGET 0x02 
♦define IPX_CMD_SEND_PACKET 0x03 
♦define IPX_CMO_LI8TEN_FOR_PACKET 0x04 
♦define IPX_CMD_SCHEDULE_IPX_EVENT 0x05 
♦define IPX_CMD_CANCEL_EVENT 0x06 
♦define IPX_CMD_GET_INTERVAL„MARKER 0x08 
♦define IPX_CMD_GET_INTERNETWORK_ADDRESS 0x09 
♦define IPX„CMD_RELINQUISH_CONTRQL 0x6a 
♦ define IPX_CMD_DISCONNECT_FROH_TARGET 0x0b 


■ДИАЛОГ-МИФИ- 
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И - 

// Коды ошибок 

// --- 

♦define NO_ERRORS О 

♦define ERR_NO_IPX 1 

♦define ERR_NO_SPX 2 

♦define NO_LOGGED_ON 3 

♦ define UNKNOWN_ERROR Oxff 

/; - 

// Константы 

n .. 

♦define SHORT_LIVED 0 
♦define LONG_LIVED Oxff 
♦define IPX_DATA_PACKET_MAXSIZE 546 
// Максимальный размер буфера данных 
♦define BUFFER_SIZE 512 

// Внешние процедуры для инициализации и вызова драйвера IPX/SPX 

extern "d" void far ipxspx_entry(void far *ptr); 

extern "C” int ipx_init(void)j 

extern unsigned IntSwap(unsigned i); 

void XPXRelinquishControl(void); 

// Структура для вызова драйвера IPX/SPX 
struct IPXSPX_REGS { 

unsigned int axj 

unsigned int bx* 

unsigned int dxj 

unsigned int sij 

unsigned int di; 

unsigned int esj 

>; 

II Класс динамических сокетов 
class DYNAMIX_SOCKET { 
publics 

unsigned errno; 
unsigned Socket; 

Struct IPXSPX_REGS iregs; 

// Конструктор динамического сокета. 

// Открывает сокет и запоминает его номер. 

DYNAMIX_SOCKET () { 

iregs. Ьх - IPX_CMD_OPEN_SOCKET; 
iregs.dx = 0; 
iregs.ax = 0; 

ipxspx_entry( (void far *)siregs ); 
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Socket = iregs.dx; 

>J 

// Деструктор. Закрывает ранее открытый сокет. 
"DYNAMIX_SOCKET() { 

iregs.bx - IPX_CMD_CLOSE_SOCKET; 

iregs.dx •> Socket; 

ipxspx_entry( (void far *)&iregs ); 

>! 

>» 

// Класс программ-клиентов IPX 

class IPX_CLIENT { 

public; 

unsigned errno; 

// Сокет, с которым работает программа-клиент 
DYNAMIX_SOCKET ‘Socket; 

// Конструктор. Выполняет инициализацию клиента; 

// инициализирует драйвер IPX и открывает динамический сокет. 


IPX_CLIENT( ) { 

if(ipx_lnit( ) !- Oxff ) { 

errno - Oxff; return; 

>. 

Socket - new DYNAMIX_SOCKET; 

> 

// Деструктор. Автоматически закрывает 
// сокет при завершении работы программы. 
"IPX_CLIENT( ) { 

delete Socket; 

} 

// Функция, определяющая конфигурацию сети 
void Go(void); 

>; 

// Класс заголовков ІРХ-пакетов. 
struct IPX_HEADER { 

// Структура, описывающая заголовок 


struct _IPX_HEADER { 
unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned char 
unsigned char 
unsigned int 


Checksum; 

Length; 

TransportControl; 
PacketType; 
DestNetwork[4]; 
DestNode[6); 
DestSocket; 
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unsigned char SourceNetwork[4 ] 5 

unsigned char SourceNode[6]; 

unsigned int SourceSocket; 

> _ipx_header; 

11 Конструктор. Записывает в заголовок тип пакета, 

// нулевой номер сети, в которую будет отправлен пакет, 
// адрес OxFFFFFFFFFFFF в качестве адреса назначения, 

// номера сокетов адресата и отправителя пакета, 

IPX_HEADER ( unsigned Socket, unsigned SrcSocket) { 
_lpx_header.PacketType -4; 
meraset(_lpx_header .DestNetwork, 0, 4) ; 
memeet(_ipx_header .DestNode, Oxff, 6); 
_ipx_header.DestSocket = Socket; 

_ipx_header. SourceSocket « SrcSocket; 

> 

// Конструктор. Записывает в заголовок тип пакета, 

// нулевой номер сети, в которую будет отправлен пакет, 
// адрес OxFFFFFFFFFFFF в качестве адреса назначения. 

IPX_HEADER( ) { 

_ipx_header . PacketType = 4; 
memset(_ipx_header .DestNetwork, 0, 4); 
memset(_ipx_header .DestNode, Oxff, 6); 


// Класс блоков ECB. 


struct ECB { 

// Сам блок ECB в стандарте IPX/SPX. 


struct _ECB { 

void far ‘Link; 

void far (‘ESRAddress)(void) ; 


unsigned char 
unsigned char 
unsigned int 
unsigned int 
unsigned int 
unsigned char 
unsigned char 
unsigned int 

void far 
unsigned 
} Packet[2]; 

> _.ecb; 


InOse; 

CCode; 

Socket; 

Connectionld; 
RrestOfWorkspace; 
DriverWorkspace[X2]; 
ImniAddress [ 6 ]; 
FragmentCnt; 

‘Address; 
int Size; 


И Указатель на заголовок пакета, связанного с данным ЕСВ. 
struct IPX_HEADER ‘IPXHeader; 
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// Структура для приема ответа от станции 
И после посылки диагностического пакета, 
struct Reply { 

unsigned char MajVer; 
unsigned char MinVer; 

unsigned Socket; . , 

unsigned char NumberOfComponents; 
unsigned char Buffer!512]; 

} Rep; 

// Структура для хранения диагностического пакета, 
struct DiagnRequest { 

unsigned char Exclusions; 
unsigned char List[80]]6]; 

> DReq; 

struct IPXSPX_REGS iregs; 

// Конструктор. Создается заголовок пакета, 

// в блок ЕСВ записывается номер сокета, используемого клиентом, 

// инициализируются счетчик фрагментов и дескрипторы фрагментов. 

// В качестве непосредственного адреса указывается 
И адрес OxFFFFFFFFFFFF . 

ЕСВ( DYNAMIX_SOCKET ‘Socket) { 

IPXHeader = new IPX_HEADER; 
memset(S_ecb, 0, sizeof(_ecb)); 

_ecb.Socket = Socket->Socket; 

_ecb.FragmentCnt «=2; 

_ecb. Packet] 0 ] .Address « &( IPXHeader->_ipx_header),.; 
_ecb. Packet [ 0 ]. Size = 30,; v 

_ecb.Packet]1].Address = SRep; 

_ecb.Packet[1].Size = sizeof(Rep); 

memset(_ecb.InanAddress, Oxff, S) J ; 

} 

// Конструктор. Создается заголовок пакета, в блок ЕСВ записывается 
// номер сокета, используемого клиентом, а также номер сокета 
// адресата, инициализируются счетчик фрагментов и дескрипторы 
II фрагментов. В качестве непосредственного адреса указывается 
// адрес OxFFFFFFFFFFFF. 

ЕСВ( DYNAMIX_SOCKET ‘Socket, unsigned DstSocket) { 

IPXHeader = new IPX_HEADER(IntswapfDstSocket), 
Socket->Socket); 

// Запрос адресуется всем станциям без исключения. 

DReq.Exclusions = 0; 
memset(&_ecb, 0, sizeof(_ecb) ); 

_ecb.Socket = Socket->Socket; 

_ecb.FragmentCnt = 2; 

' _ecb.Packet]0].Address = s(IPXHeader->_ipx_header); 
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_ecb.Packet[0]-Size =30} 

_ecb.Packet[l].Address = SDReq} 

_ecb.Packet[1].Size = sizeof(DReq); 
memset(_ecb.IramAddress, Oxff, 6)} 

} 

//Прием ІРХ-пакета. 

void ListenForPacket(void) { 

iregs.es = FP_SEG((void far*)S_ecb)} 
iregs.si = FP_OFF((void far*)S_ecb); 
itegs.bx = IPX_CMD_LISTEN_FOR_PACKET} 
ipxspx_entry( (void far *)&iregs ); 

> 

// Передача ІРХ-пакета. 

void SendPacket (void) .{ 

iregs.es = FP_SEG((void far*)fi_ecb); 
iregs.si = FP_OFF((void far*)&_ecb); 
iregs.bx = IPX_CMD_SEND_PACKET; 
ipxspx_entry( (void far *)&iregs ); 

> 

// Распечатать принятый пакет конфигурации 
void PrintDiagnostics(void) ; 

}» 

: В файл ipx.cpp (листинг И) мы вынесли остальные используемые програм¬ 
мой функции, в частности функцию PrintDiagnostics(). Кроме того, программа 
вызывает функции, определенные в файле ipxdrv.asm, содержимое которого уже 
было приведено нами раньше. 

} ! / листинг 11. Функции IPX. 

// 

// Файл ipx.cpp 

// ч 

// 1$) A. Frolov, 1993 

«include <stdio.h> 

«include <stdlib.h> 

* inpj-udn <dos.h> 

«include <conio.h> 

«include "ipx.hpp" 

/*$,.. . 

* .Name IntSwap 

* .Title Обмен байтов в слове 

* . Descr функция меняет местами байты в слове, 
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которое передается ей в качестве параметра 
■Farams unsigned i - преобразуемое словр 

•Return Преобразованное слово 

'/ 

isigned IntSwap(unsigned i) < 

return) (i»8) I (i & 0xff)«8); 

•Name IPXRelinquishControl 

•Title Передать управление IPX при ожидании 

•Descr Функция используется при ожидании 

завершения приема через опрос поля InUse 

. Params Не используются 


* .Return Ничего 

void IPXRelinquishControl)void) { 
struct IPXSPX_REGS iregs; 
iregs.bx = IPX_CMD_RELINQUIS H_CONTROL; 
ipxspx_entry( (void far *)siregs ); 

} 

// Функция для печати содержимого принятого пакета конфигурации, 
void ЕСВ:: PrintDiagnostics ) void) { 

int i, j, k, networks, component; 

// Печатаем конфигурацию только для тех ЕСВ,в поле InUse которых 
// стоит нулевое значение, т.е. если был принят пакет, 
if)!_ecb.InUse) { 

// Распечатываем версию диагностической поддержки, номер сокета для 
// SPX -диагностики и количество компонентов программного 
//обеспечения, работающего на станции. 

printf("\n%d.%d\t%d\t%dSt\t", 

Rep.MajVer, Rep.MinVer, 

Rep.Socket, Rep.NumberOfComponents); 

// Распечатываем номер сети, из которой пришел пакет конфигурации, 
for) і=0;і<4 ; і++) { 

printf ("%02.2Х", (unsigned char) 

IPXHeader->_ipx_header.SourceNetwork[i])• 

> 

printf)“\t"); 

" ДИАЛОГ-МИФИ ~ 
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// Распечатываем сетевой адрес станции, из 
// которой пришел пакет конфигурации. 

for (1-0 ; i<6; І++) { 

printf("%02.2X",(unsigned char) 

IPXHeader->_ipx_header.SourceNode[i])j 

> 

printf ("\n\n") ; 

II Для каждого программного компонента распечатываем ( 
f or ( і=0; i<Rep .NumberOf Components ;) { 

switch(component=Rep.Buffer[i)) { 
case 0: 

printf ("идрайвер lPX/SPX\n" ); 
i++; 

printf("XtflpafiBep моста\п“ ); 

І-Й-; 

break; 

printf (" NtflpaflBep сетевой оболочкиХп" ); 
i++; 
break; 
case 3: 

printf(" \ЦСетевая оболочка\п" ); 

i++; 

break; 

printf("\t06ono4Ka VAP\n"); 
i++; 

II Для мостов и серверов дополнительно выводим количество 
7/ подключенных к ним сетей,тип каждой сети, номера подключенных 
// сетей и сетевые адреса адаптеров. 


switch(component) { 


printf ("\ЦФайл-сервер/внутренний 

printf ( "^Невыделенный сервер\п“ ); 
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// Количество подключенных сетей 

printf ( "\t\tnoHKn104eHO сетей: %d" , 
(unsigned char)Rep.Buffer[i] )} 
networks = Rep.Buffer[i]; 
i++i 

// Для каждой сети печатаем ее тип, 

// номер сети и сетевой адрес адаптера. 

for(j=0; j<networkS(j++) { 


П Тип сети 


// Номер сети 


printf ( "\n\t\t\tTHn сети: %d\t", 
(unsigned char) 

Rep.Buffer! i++J) I 


for(k=0 jk<4;k++,i++) { 

printf ("%02.2X“,(unsigned char) 
Rep.Buffer[i]); 

} 

printf(“\t" 

11 Сетевой адрес адаптера 

for(k=0;k<6;k++,i++) { 

printf ( "%02. 2X" , (unsigned char) 
Rep.Buf fer[i]) ; 




Приведем образец листинга, выдаваемого программой в стандартный поток вывода: 
•Netview* vl.O, (С) Фролов А.В., 1993 
Подождите немного ... 

Конфигурация сети: 

Версия Сокет Компоненты Сеть Узел 


1.0 576 


3 00000010 

Драйвер IPX/SPX 
Драйвер моста 

Файп-сервер/внутренний мост 
Подключено сетей: 3 

Тип сети: 1 00000010 

Тип сети: 0 00000013 


000000000001 


000000000001 

48450000456С 


■ ДИАЛОГ-МИФИ " 
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1.0 576 


1.1 320 


1.1 320 


1.0 320 


1.1 320 


1.1 320 


Тип сети: 0 00000012 

3 0000000Е 

Драйвер IPX/SPX 
Драйвер иоста 

Файл-сервер/внутренний мост 
Подключено сетей: 2 

Тип сети: 1 0000000Е 

Тип сети: 0 00000012 

3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 
3 00000012 

Драйвер XPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 
3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 
3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 
3 00000012 


1.1 


1.1 


1.1 


Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 

320 3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 

320 3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки. 
Сетевая оболочка 

320 3 00000012 

Драйвер IPX/SPX 
Драйвер сетевой оболочки 
Сетевая оболочка 

320 3 00000012 

Драйвер IPX/SPX 


4845000047С7 

000000000001 


000000000001 

008428801E9D 

008058801С82 


484500004666 


484500004889 


008058801FOF 


000561E5D284 


008058801E1D 


484506004726 


008058801ЕВ5 


484556004705 
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Драйвер сетевой оболочки 
Сетевая оболочка 

Из приведенного листинга видно, что в сети имеются два файл-сервера и 9 
рабочих станций. Все рабочие станции находятся в сети 00000012. К этой же 
сети подключены оба файл-сервера. Первый в списке файл-сервер подключен к 
сетям 00000012 и 00000013, следовательно, этот файл-сервер является внутрен¬ 
ним мостом между сетью 00000012 и 00000013. 

Обратите внимание, что для двух файл-серверов, имеющихся в сети, указан 
тип сети 1 и номера сетей 10h и OEh. Это так называемые внутренние номера 
сетей, которые задавались при генерации Novell NetWare версии 3.11. Физичес¬ 
кие сети имеют в нашем случае номера 12 и 13. 

2.8. Настройка параметров IPX 

Мы уже говорили, что драйвер протоколов IPX/SPX для MS-DOS реализован в 
виде резидентной программы. В версии 3.11 операционной системы Novell 
NetWare на рабочих станциях MS-DOS используется программа ipxodi.com. 

При запуске этой программы вы можете указать параметры "d" и "а”. Если указыва¬ 
ется параметр "d", на рабочей станции не загружается диагностический- сервис, что 
экономит примерно 4 Кбайт памяти. Если же указывается параметр "а”, в память за¬ 
гружается только драйвер протокола IPX, а драйвер протокола SPX и диагностический 
сервис не загружаются. При этом освобождается 8 Кбайт основной памяти. 

Однако учтите, что такие сетевые утилиты, как RCONSOLE и NVER, тре¬ 
буют присутствия драйвера протокола SPX и диагностического сервиса. 

Заметим также, что вы можете менять некоторые параметры драйверов IPX и SPX. 
Для этого в первых строках файла net.cfg, расположенного в каталоге C:\NET (см. пре¬ 
дыдущий том "Библиотеки системного программиста") можно указывать параметры: 
IPX RETRY COUNT Параметр определяет, сколько раз будет выполнена повтор¬ 
ная передача пакета, прежде чем будет сделан вывод о 
невозможности его передачи. Сам протокол IPX не выпол¬ 
няет повторные передачи (так как этот протокол не гаран¬ 
тирует доставку передаваемых пакетов), но это значение 
используется протоколами более высокого уровня, реализо¬ 
ванными на базе IPX, в частности 1 протоколом SPX. 

По умолчанию пакет передается 20 раз. 

IPX SOCKETS Параметр определяет максимальное количество сокетов, 

которые программа может открыть на рабочей станции. 
По умолчанию можно открыть 20 сокетов. 

Например, для увеличения числа доступных сокетов до 50 добавьте в начало 
файла net.cfg строку ірх sockets=so. 

Составляя документацию по установке разрабатываемого вами сетевого прог¬ 
раммного обеспечения, не забудьте упомянуть о том, как надо настраивать па¬ 
раметры протокола IPX (если такая настройка необходима для нормальной 
работы вашей программы). 

■ДИАЛОГ-МИФИ' 






Глава 3 

ПРОТОКОЛ SPX 

Для некоторых приложений (например, для программ, передающих файлы 
между рабочими станциями) удобнее использовать сетевой протокол более 
высокого уровня, обеспечивающий гарантированную доставку пакетов в пра¬ 
вильной последовательности. Разумеется, ваша программа может сама следить 
за тем, чтобы все переданные пакеты были приняты. Однако в этом случае вам 
придется делать собственную надстройку над протоколом IPX - собственный 
протокол передачи данных. 

Прежде чем принять решение о создании собственного протокола, изучите 
протокол SPX - протокол последовательного обмена пакетами (Sequenced 
Packet Exchange Protocol), разработанный Novell. Возможно, что протокол SPX 
удовлетворит потребности вашей программы в гарантированной передаче дан- 



3.1. Формат пакета SPX 

Пакет, передаваемый при помощи протокола SPX, имеет более длинный за¬ 
головок. Дополнительно к 30 байтам стандартного заголовка пакета IPX добав¬ 
ляется еще 12 байт (рис. 4). 

Checksum - контрольная сумма 
Length - общая длина пакета 
TransportContro! - счетчик пройденных мостов 
PacketType - тип пакета 
DestNetwork - номер сети получателя пакета 
I I DestMode - адрес станции-получателя 

DestSocket- сокет программы-получателя 
SourceNetwork- номер сети отправителя пакета 
I I SourceNode - адрес станции-отправителя 

SourceSocket - сокет программы-отправителя 
ConnContro! - управление потоком данных 
DataStreamType - тип данных в пакете 
SourceConnID - идентификатор канала отправителя 
DestConnID - идентификатор канала получателя 
SeqNumber - счетчик переданных пакетов 
AckNumber - номер следующего пакета 
Altoc^umber - количество буферов для приема 

Рис. 4. Формрт заголовка пакета SPX 
Приведем структуру заголовка пакета SPX дня использования в программах, 
составленных на языке Си: 
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struct SPX_HEADER { 

unsigned int 

unsigned char 
unsigned char 
unsigned char 
unsigned int 
unsigned char 
unsigned char 


// - 


Checksum; 

Length; 

TransportControl; 
PacketType; 
DestNetwork[4]; 
DestNode[6]; 
DestSocket; 
SourceNetwork[4]; 
SourceNode[6]; 
SourceSocket: 


— Специфическая для SPX часть 
unsigned char ConnControl; 
unsigned char DataStreamType; 




SourceConnID[2 ]; 
r DestConnID[2]; 
r. SequenceNumber [ 2 ]; 
r AckNumber[2]; 
r AllocationNumber[2]; 


Поле ConnControl можно рассматривать к 
лающих передачей данных по каналу SPX: 


і набор битовых флагов, управ- 


Биты Назначение 

01h-08h Зарезервировано 

10h End-of-Message. Этот бит. может использоваться программой для 

сигнализации окончания передачи данных. Драйвер SPX передает 
этот бит программе в неизменном виде, причем сам драйвер прото¬ 
кола SPX этот бит игнорирует 

20h Attention. Этот бит игнорируется драйвером SPX и передается в 

неизменном виде программе 

40h Acknowledgement Required. Бит используется драйвером SPX. Вам 

не следует модифицировать его значение 
80h System Packet. Этот бит устанавливается драйвером SPX при пере¬ 

даче системных пакетов, которые используются самим драйвером и 
не передаются в программу пользователя 

Поле DataStreamType также состоит из однобитовых 
тспользуются для классификации данных, передаваемых или 
помощи протокола SPX. Приведем возможные значения поля 


флагов, которые 
принимаемых при 
DataStreamType: 


' ДИАЛОГ-МИФИ' 
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Биты Назначение 

OOh-FDh Эти значения игнорируются драйвером SPX и могут быть использо¬ 
ваны программой произвольным образом 
FEh End-of-Connection. Когда программа вызывает функцию, закрываю¬ 

щую §РХ-канал, драйвер SPX посылает партнеру по связи последний 
пакет, в поле DataStreamType которого записано значение FEh. Это 
служит требованием завершить связь и закрыть канал 
FFh End-of-Connection-Acknowledgement. Это значение отмечает пакет, 

подтверждающий завершение связи. Такой пакет является системным 
и не передается в программу пользователя 

Поле SourceConnlD содержит номер канала связи передающей программы, 
присвоенный драйвером SPX при создании канала связи. Этот номер должен 
указываться функции передачи пакета средствами SPX. 

Поле DestConnID содержит номер канала связи принимающей стороны. Так 
как все пакеты приходят на один номер сокета и могут принадлежать разным 
каналам связи (на одном сокете можно открыть несколько каналов связи), вам 
необходимо классифицировать приходящие пакеты по номеру канала связи. 

Поле SeqNumber содержит счетчик пакетов, переданных по каналу в одном 
направлении. На каждой стороне канала используется свой счетчик. После до¬ 
стижения значения FFFFh счетчик сбрасывается в нуль, после чего процесс 
счета продолжается. 

Содержимым этого поля управляет драйвер SPX, поэтому программа не дол¬ 
жна менять его значение. 

Поле AckNumber содержит номер следующего пакета, который должен быть 
принят драйвером SPX. 

Содержимым этого поля управляет драйвер SPX, поэтому программа не дол¬ 
жна менять его значение. 

Поле AllocNumber содержит количество буферов, распределенных програм¬ 
мой для приема пакетов. 

Содержимым этого поля управляет драйвер SPX, поэтому программа не дол¬ 
жна менять его значение. 

3.2. Блок ЕСВ 

Для протокола SPX используется точно такой же блок ЕСВ, что и для про¬ 
токола IPX. 
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3.3. Функции SPX 
3.3.1. Инициализация SPX 


SPXChecklnstallation 


На входе: ВХ = 
AL = 
На выходе: AL = 


ВН = 
BL = 
СХ = 

DX = 


10h. 

00h. 

Код завершения: 

00h - SPX не установлен; 

FFh - SPX установлен. 

Верхний (major) номер версии SPX. 

Нижний (minor) номер версии SPX. 

Максимальное количество каналов SPX, поддерживаемых 
драйвером SPX. 

Количество доступных каналов SPX. 


Прежде чем использовать функции SPX, программа должна вызвать функцию 
SPXChecklnstallation для того, чтобы убедиться в наличии драйвера SPX. 


3.3.2. Образование канала связи 
SPXListenForConnection 


На входе: 


ВХ = 12h. 

AL = Счетчик повторов попыток создать канал связи. 

АН = Флаг включения системы периодической проверки связи 
(Watchdog Supervision Required Flag). 

ES:SI = Указатель на блок ЕСВ. 


На выходе: Регистры не используются. 

Эта функция используется в паре с функцией SPXEstablishConnection для об¬ 
разования канала связи. 

Программа-сервер вызывает SPXListenForConnection, передавая ей адрес блока 
ЕСВ. Этот блок будет использован для образования канала связи. Когда прог¬ 
рамма-клиент вызовет функцию SPXEstablishConnection, произойдет образование 
канала связи и в поле InUse блока ЕСВ будет записано нулевое значение. Будет 
также вызвана соответствующая программа ESR, если задан ее адрес. 

В блоке ЕСВ необходимо определить значение поля ESRAddress и указать 
номер сокета. Для каждого сокета вы можете образовать несколько каналов. 

Блок ЕСВ, адрес которого задан в регистрах ES:SI, ставится драйвером SPX 
во внутреннюю очередь блоков ЕСВ, ожидающих прихода пакетов от функций 
SPXEstablishConnection, выдаваемых другими станциями, желающими образо¬ 
вать канал связи. 

После образования канала связи, когда в поле InUse будет записано нулевое 
значение, поле CCode блока ЕСВ будет содержать код завершения: 


-ДИАЛОГ-МИФИ' 
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канал связи создан, ошибок нет; 
указанный в ЕСВ сокет не был открыт; 
запрос SPXListenForConnection был отменен функциями 
IPXCancelEvent или IPXCloseSocket (ESR не вызывается); 
переполнилась внутренняя таблица номеров каналов связи; до тех пор, 
пока какой-нибудь канал не будет закрыт, вы не сможете образовать 
новые каналы. 

Перед вызовом функции SPXListenForConnection программа должна выделить 
хотя бы один ЕСВ для приема SPX -пакета. Это нужно сделать при помощи 
функции SPXListenForSequencedPacket (см. ниже описание функции). 

Вам также надо задать в регистре AL счетчик повторов попыток создания 
канала связи и в регистре АН - флаг включения системы периодической про¬ 
верки связи. Вы можете задать от 1 до 255 попыток или использовать значение 
по умолчанию, если запишете в регистр AL нулевое значение. 

Если в регистр АН будет записано ненулевое значение, драйвер SPX будет пе¬ 
риодически проверять работоспособность канала связи, передавая специальные те¬ 
стовые пакеты. Если канал вдруг перестает работать, он разрывается и в ЕСВ, под¬ 
готовленный для приема пакетов функцией SPXListenForSequencedPacket, в поле 
InUse проставляется нулевое значение. Поле CCode при этом будет содержать код 
ошибки EDh, а номер "испорченного" канала будет записан в первых двух байтах 
поля IPXWorkspace блока ЕСВ. 


SPXEstablishConnection 


На входе: ВХ = 
AL = 
АН = 

ESrSI = 


llh. 

Счетчик повторов попыток создать канал связи. 

Флаг включения системы периодической проверки связи 
(Watchdog Supervision Required Flag). 

Указатель на блок ЕСВ. 


На выходе: AL = Промежуточный код завершения: 

00h - выполняется попытка создать канал; 

FFh - указанный в блоке ЕСВ сокет закрыт; 

FDh - сбойный пакет: либо счетчик фрагментов не 
равен 1, либо размер фрагмента не равен 42; 
EFh - переполнение локальной таблицы номеров 
каналов связи. 

DX = Присвоенный номер канала. 


Функция устанавливает канал связи с программой, предварительно вызвав¬ 
шей функцию SPXListenForConnection. 

Для функции необходимо подготовить блок ЕСВ и пакет в формате SPX, со¬ 
стоящий из одного заголовка. В блоке ЕСВ необходимо заполнить поля 
ESRAddress, Socket, счетчик количества фрагментов (нужен один фрагмент) и 
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указатель на фрагмент размером 42 байта. В заголовке SPX -пакета необходимо 
заполнить поля DestNetwork, DestNode, DestSocket. 

Кроме того, перед вызовом функции S PXLi stenFoiConnection программа должна 
вьщелить хотя бы один ЕСВ для приема SPX -пакета. Это нужно сделать при 
помощи функции SPXListenForSequencedPacket (см. ниже описание функции). 
Канал создается в два приема. 

На первом этапе проверяется возможность образования канала - проверяется 
наличие свободного места в таблице номеров каналов, проверяется таблица 
сокетов, размер пакета. Если все хорошо, с целью попытки создать канал уда¬ 
ленному партнеру посылается пакет, после чего функция возвращает управле¬ 
ние вызвавшей ее программе. Регистр AL при этом содержит промежуточный 
код завершения. Если этот код равен нулю, можно переходить к ожиданию 
приема ответного пакета от партнера по созданию канала. Регистр DX при этом 
содержит номер присвоенного канала. 

Если партнер отвечает соответствующим образом, в поле InUse блока ЕСВ 
устанавливается нулевое значение. Если при этом в поле CCode также нахо¬ 
дится нулевое значение, канал считается созданным. 

Номер канала удаленного партнера, который вы будете использовать для' пе¬ 
редачи ему пакетов функцией SPXSendSequencedPacket, находится в поле 
SourceConnID блока ЕСВ. Сохраните его для дальнейшего использования. 

Если по каким-либо причинам канал создать не удалось, в поле CCode будет 
записан код ошибки: 

OOh канал связи создан, ошибок нет; 

FCh запрос SPXListenForConnection был отменен функциями 
IPXCancelEvent или IPXCloseSocket (ESR не вызывается); 

FDh сбойный пакет: либо счетчик фрагментов не равен единице, либо 
размер фрагмента не равен 42; 

FFh указанный в ЕСВ сокет не был открыт; 

EFh переполнилась внутренняя таблица номеров каналов связи; до тех пор, 
пока какой-нибудь канал не будет закрыт, вы не сможете образовать 
новые каналы; 

EDh адресат не отвечает или сообщает, что он не может создать канал; этот 
код может возникнуть либо как результат неисправности сетевого 
аппаратного обеспечения, либо если функция SPXEstablishConnection 
была отменена при помощи функции SPXAbortConnection. 

.Обратим ваше внимание на то, что для отмены создания канала необхо¬ 
димо пользоваться специально предназначенной для этого функцией 
SPXAbortConnection, а не функцией IPXCancelEvent. 


■ДИАЛОГ-МИФИ- 
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3.3,3. Прием и передача пакетов 

SPXListenForSequencedPacket 
На входе: ВХ = 17h. 

ES:SI = Указатель на блок ЕСВ. 

На выходе: Регистры не используются. 

Функция обеспечивает прием пакетов средствами протокола SPX. При этом она 
ставит блок ЕСВ, адрес которого передается через регистры ES:SI, в очередь на 
прием, после чего немедленно возвращает управление вызвавшей программе. 

После того как пакет будет принят, в поле InUse блока ЕСВ устанавливается 
нулевое значение, а в поле CCode - код завершения: 

00h пакет принят без ошибок; 

FCh запрос SPXListenForSequencedPacket был отменен функциями 
IPXCancelEvent или IPXCloseSocket (ESR не вызывается); 

FDh переполнение пакета - принятый пакет имеет длину, которая превосхо¬ 
дит размер буферов, указанных в дескрипторах фрагментов; 

EDh система периодической проверки связи обнаружила разрыв канала, 
номер разрушенного канала записан в первых двух байтах поля 
IPXWorkspace блока ЕСВ; 

FFh указанный в ЕСВ сокет не был открыт. 

Перед вызовом функции необходимо заполнить в ЕСВ поля ESRAddress, 
Socket, счетчик фрагментов и дескрипторы фрагментов. При этом первый 
фрагмент передаваемого пакета должен иметь длину не менее 42 байт - это 
буфер для приема стандартного заголовка SPX -пакета. Необходимо также от¬ 
крыть используемый сокет при помощи функции IPXOpenSocket. 

Обычно для приема пакетов используется несколько блоков ЕСВ. Все они по¬ 
следовательно ставятся в очередь функцией SPXListenForSequencedPacket. Для 
приема пакета драйвером SPX может быть использован любой свободный блок 
ЕСВ. Не гарантируется, что блоки ЕСВ будут использованы именно в том порядке, 
в котором они ставились в очередь функцией SPXListenForSequencedPacket. 

Если принимается системный пакет, использованный блок ЕСВ автомати¬ 
чески возвращается в очередь для приема пакетов. 

Так как для обработки системных пакетов протокол гарантированной доставки SPX 
использует те же блоки ЕСВ, что и для приема прикладных пакетов, ваша программа 
должна обеспечить достаточное количество блоков ЕСВ в очереди на прием пакетов. 

Если принимается пакет, у которого в заголовке в поле DataStreamType нахо¬ 
дится значение FEh, это означает, что передающая программа собирается завер¬ 
шить передачу и закрыть канал. При этом все блоки ЕСВ, стоящие в очередь на 
передачу пакетов (в которую они ставятся функцией SPXSendSequencedPacket, 
описанной шоке), отмечаются нулевым значением в поле InUse и соответствующим 
кодом завершения в поле CCode. 
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Программа может отменить ожидание завершения приема пакета для блока ЕСВ 
при помощи функции IPXCancelEvent, при этом она должна заново проинициа- 
лизировать поле ESRAddress перед повторным использованием этого блока ЕСВ. 

SPXSendSequencedPacket 
На входе: ВХ = 16h. 

ES:SI = Указатель на блок ЕСВ 

DX = Номер канала связи. 

На выходе: — Регистры не используются. 

Функция ставит блок ЕСВ, адрес которого указан в регистрах ES:SI, в очередь 
на передачу, после чего немедленно возвращает управление вызвавшей программе. 

Перед вызовом функции программа должна заполнить поле ESRAddress, 
счетчик фрагментов и дескрипторы фрагментов блока ЕСВ, а также бит End- 
Of-Message в поле ConnControl и поле DataStreamType в заголовке пере¬ 
даваемого пакета. Разумеется, заголовок должен иметь длину 42 байта. 

В регистр DX необходимо загрузить номер канала, используемый партнером. 

В отличие от средств передачи пакета протокола IPX успешное завершение 
передачи пакета, инициированной функцией SPXSendSequencedPacket, гаранти¬ 
рует доставку пакета партнеру. Если партнер не успевает принимать передавае¬ 
мые пакеты, они ставятся в очередь на передачу, чем обеспечивается правиль¬ 
ная последовательность доставки пакетов. 

После завершения передачи пакета поле InUse блока ЕСВ имеет нулевое 
значение. Если определена программа ESR, она вызывается. В поле CCode на¬ 
ходится код завершения: 

00h пакет был передан и успешно принят партнером; 

FCh указанный в ЕСВ сокет был закрыт, программа ESR не вызывается; 

FDh сбойный пакет: либо счетчик фрагментов равен нулю, либо размер 

первого фрагмента меньше 42 байт, либо размер всего пакета больше 
576 байт; 

EEh неправильное значение в регистре DX; 

EDh либо система периодической проверки связи обнаружила разрыв кана¬ 
ла, либо канал был уничтожен функцией SPXAbortConnection (номер 
разрушенного канала записан в первых двух байтах поля IPXWorkspace 
блока ЕСВ); 

ECh удаленный партнер закрыл канал без подтверждения приема этого паке¬ 
та, при этом SPX не может гарантировать, что переданный пакет был 
успешно принят партнером перед тем, как канал был закрыт. 

Для отмены передачи пакета нельзя использовать функцию IPXCancelEvent. 
Вместо нее необходимо использовать функцию SPXAbortConnection. 
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3.3.4. Разрыв канала связи 


SPXTerminateConnection 
На входе: ВХ = 13h. 

ES:SI = Указатель на блок ЕСВ. 

DX = Номер канала связи. 

На выходе: Регистры не используются. 


Функция посылает удаленному партнеру пакет, который состоит из одного 
заголовка. В поле DataStreamType этого заголовка находится значение FEh, 
которое говорит партнеру о том, что необходимо закрыть канал. Сразу после 
вызова функция возвращает управление вызывавшей ее программе. 

Перед вызовом функции программа должна заполнить поле ESRAddress, 
счетчик фрагментов (в пакете должен быть один фрагмент размером 42 байта) 
и дескриптор фрагмента блока ЕСВ. 

В регистр DX необходимо загрузить номер канала, используемьш партнером. 
После завершения процесса закрытия канала в поле InUse блока ЕСВ про¬ 
ставляется нулевое значение и вызывается программа ESR (если она была зада¬ 
на). В поле CCode проставляется код завершения: 

00h канал был успешно закрыт; 

FDh сбойный пакет: либо счетчик фрагментов не равен единице, либо раз¬ 
мер фрагмента меньше 42 байт; 

EEh неправильное значение в регистре DX; 

EDh канал закрылся с ошибкой, при этом удаленный партнер не прислал 
пакет, подтверждающий закрытие канала. При этом SPX не гаранти¬ 
рует, что партнер успешно закрыл канал со своей стороны; 

ECh удаленный партнер закрыл канал без подтверждения команды закрытия 
канала, при этом SPX не может гарантировать, что партнер вызвал 
функцию, закрывающую канал. 

После закрытия канала освобождается место в таблице номеров каналов. 
Программа может открывать новые каналы. 

Заметим, что для отмены ожидания завершения процесса закрытия канала 
необходимо использовать функцию SPXAbortConnection, а не IPXCancelEvent. 


SPXAbortConnection 


На входе: 

ВХ 

14h. 


DX 

Номер канала связи. 

На выходе: 


Регистры не используются. 

Функция 

разрывает канал связи без "согласования" с партнером. Данная 


функция должна использоваться только в катастрофических случаях, когда 
невозможно выполнить нормальную процедуру закрытия канала. 

После вызова этой функции во всех ЕСВ, относящихся к данному каналу в 
поле CCode проставляется значение EDh. 
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3.3.5. Проверка состояния канала 

SPXGetConnectionStatus 

На входе: ВХ = 15h. 

DX = Номер канала связи. 

ES:SI = Указатель на буфер размером 44 байта. 

На выходе: AL = Код завершения: 

00h - канал активен; 

EEh - указанный канал не существует. 

С помощью функции SPXGetConnectionStatus программа может проверить 
Состояние канала. Если канал существует, в буфер, адрес которого задан в ре¬ 
гистрах ES:SI, записывается информация о состоянии канала. 

Приведем формат буфера в виде структуры: 
struct CSB { 

unsigned char ConnectionState; 
unsigned char ConnectionFlags; 
unsigned char SrcConnectionID[2]; 
unsigned char DestConnectionID[2]; 
unsigned char SeqNumber[2]; 
unsigned char AckNumber[2]; 
unsigned char AllocNumber[2]; 
unsigned char RemoteAckNumber[2]; 
unsigned char RemoteAllocNumber[2]; 
unsigned char ConnectionSocket[2]j 
unsigned char ImmAddress[6]; 
unsigned char DestNetwork[4]j 
unsigned char DestNode[6]; 
unsigned char DestSocket[2]; 
unsigned char RetransmissionCountt2]; 
unsigned char EstimatedRoundtripDelayl2]; 
unsigned char RetransmittedPackets[2]; 
unsigned char SuppressedPackets[2]; 

): 

Все поля в этой структуре имеют "перевернутый" формат, в котором млад¬ 
шие байты записаны по старшему адресу. 

Поле ConnectionState отображает текущее состояние канала: 

Olh драйвер SPX находится в состоянии ожидания приема пакета, посылае¬ 
мого функцией SPXEstablishConnection; 

02h драйвер SPX пытается создать канал с удаленной рабочей станцией 
после вызова функции SPXEstablishConnection; 

03h канал создан; 

04h канал закрыт. 
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Поле ConnectionFlags содержит флат, которые используются драйвером 
SPX для управления каналом. Бит 02h, в частности, управляет использованием 
системы периодической проверки связи. Если этот бит установлен в единицу, 
для данного канала выполняется периодическая проверка связи. 

Поле SrcConnectionID содержит номер канала, присвоенный локальной 
станции. Это тот самый номер канала, который надо загружать в регистр DX 
перед использованием функций SPX. 

Поле DestConnectionID содержит номер канала, присвоенный программе, 
работающей на удаленной станции. 

Поле SeqNumber содержит последовательный номер, которьш SPX будет 
использовать для пересылки следующего пакета по каналу. 

Поле AckNumber содержит последовательньш номер следующего пакета, ко¬ 
торый должен быть принят по каналу от удаленной станции. 

Поле AllocNumber используется драйвером SPX для контроля за пакетами, 
которые были переданы, но для которых еще не пришло подтверждение о при¬ 
еме. В нем содержится количество свободных буферов, распределенных для 
приема пакетов. 

Поле RemoteAckNumber содержит номер следующего пакета, который дол¬ 
жен быть принят на удаленной станции от локальной станции. 

Поле RemoteAllocNumber имеет назначение, аналогичное назначению поля 
AllocNumber, но относится к удаленной станции. 

Поле ConnectionSocket содержит номер сокета, который используется драй¬ 
вером SPX для приема и передачи пакетов по данному каналу. 

Поле ImmAddress содержит физігческнй сетевой адрес станции, которой будут 
передаваться пакеты. Если станция-адресат находится в другой сети, в этом поле 
будет находиться адрес моста, через который пакет сможет дойти до адресата. 

Поля DestNetwork, DestNode, DestSocket содержат компоненты полного се¬ 
тевого адреса удаленной станции, с которой локальная станция работает по Дан¬ 
ному каналу, - номер сети, физический адрес станции в сети и номер сокета. 

В поле RetransmissionCount находится максимальное значение количества 
повторных передач пакетов, по достижении которого SPX делает вывод о не¬ 
возможности завершения передачи. 

Поле EstimatedRoundtripDelay содержит время (в тиках таймера), в течение 
которого SPX ждет прихода подтверждения приема пакета от удаленной станции. 
По истечении этого времени SPX начинает выполнять повторную передачу пакета. 

Поле RetransmittedPackets содержит количество выполненных повторных 
передач пакета. 
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Поле SuppressedPackets содержит количество отвергнутых пакетов. Пакеты 
могут быть отвергнуты, если они уже были приняты ранее или в настоящий 
момент нет свободных ЕСВ для их приема. 

3.4. Простая система "клиент-сервер" на базе SPX 

Приведем простейший пример, демонстрирующий использование основных 
функций SPX. Этот пример сделан на базе предыдущего, в котором две програм¬ 
мы - клиент и сервер - общались между собой с помощью протокола IPX. 

После определения наличия драйвера IPX и получения адреса его API прог¬ 
рамма-сервер с помощью функции SPXCheckSPXInstallationO определяет при¬ 
сутствие драйвера протокола SPX. 

Затем открывается сокет для протокола IPX, подготавливается ЕСВ для приема 
пакета от клиента. Этот пакет будет передаваться с помощью протокола IPX и 
предназначен для определения адреса клиента. Аналогично предыдущему примеру 
программа-клиент посьшает пакет в текущую сеть с номером 00000000 по адресу 
FFFFFFFFFFFFh, т. е. всем станциям текущей сети. После того, как программа- 
сервер прггмет этот пакет, она сохранит в области памяти ClientlmmAddress 
непосредственный адрес станции, на котороіг работает программа-клиент. 

После этого программа-сервер, пользуясь полученным непосредственньгм ад¬ 
ресом, посылает клиенту ответный IPX -пакет, сообщая о том, что сервер при¬ 
нял пакет от клиента. 

Далее программа-сервер открьгвает еще один сокет, который будет использо¬ 
ваться протоколом SPX. Напомним, что для работьг с протоколами IPX и SPX 
необходимо выделять разньге сокетьг. 

Открьгв сокет, сервер подготавливает блок ЕСВ для прггема SPX -пакета от 
клиента. В поле непосредственного адреса копируется непосредственный адрес 
клиента, полученный после прггема от него IPX -пакета. Запрос на создание ка¬ 
нала выдает функция SPXListenForSeqiiencedPacketO. 

Далее программа-сервер подготавливает в структуре СоппЕСВ блок ЕСВ для 
созданггя канала гг вызывает функцггю создания канала с принимающей стороны 
SPXListenForConnecti6n(). 

После созданггя канала программа-сервер ожггдает прихода SPX -пакета, про¬ 
веряя в цикле содержимое поля InUse блока LsECB, распределенного ранее 
функцией SPXListenForSequencedPacketO для прггема SPX -пакетов. 

После прихода SPX -пакета сервер закрывает оба сокета и завершает свою работу. 


// Листинг 12. Сервер SPX 

// Файл spxserv.c 
// 

// (С) A. Frolov, 1993 

Ц ---============ 

# include <stdio.h> 
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# include <stdlib.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include "ipx.h" 

♦include "spx.h" 

♦define BUFFER_SIZE 512 
void main(void) { 

// Используем сокет 0x4568 

static unsigned IPXSocket = 0x4567; 
static unsigned SPXSocket = 0x4568; 

// Этот ECB используется для приема пакетов и для их передачи, 
struct ECB RxECB; 
struct ECB ConnECB, LsECB; 

// Заголовки принимаемых и передаваемых пакетов 
struct IPX_HEADER RxHeader, TxHeader; 
struct SPX — HEADER ConnHeader, LsHeader; 

// Буферы для принимаемых и передаваемых пакетов 
unsigned char RxBuffer[BUFFER_SIZE]; 
unsigned char TxBuffer[BUFFER_SIZE]; 
struct SPXParams Params; 
unsigned char ClientlnmiAddress [ 6 ]; 
printf( "\п*Сервер SPX*, (С) Фролов A., 1993\n\n“); 

II Проверяем наличие драйвера IPX и определяем 
// адрес точки входа его API 
if(ipx_init( ) != Oxff) { 

printf("IPX не загружен! \n"); exit(-l); 

> 

if( SPXCheckSPXInstgllation(SParams) != OxFF) { 
printf("SPX не загружен !\n"); exit(-l); 

> 

// Открываем сокет, на котором мы будем принимать пакеты 
if(IPXOpenSocket(SHORT_LIVED, SlPXSocket)) { 

printf ("Ошибка при открытии сокета ІРХ\п"); 
exit(-l); 

}; 

// Подготавливаем ECB для приема пакета 
memset(SRxECB, 0, sizeof ( RxECB )); 

RxECB.Socket = IntSwapfIPXSocket); 

RxECB.FragmentCnt * 2; 

RxECB.Packet!0].Address = SRxHeader; 

RxECB.Packet[0].Size - sizeof(RxHeader); 

RxECB.Packet!1].Address = RxBuffer; 
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RxECB.Packet[11.Size « BUFFER_SIZE; 
IPXListenForPacket(SRxECB); 
print£( "Ожидание запроса от хлиента\п"); 
printf ("Для отмены нажмите любую клави'лу\п" ); 
while ( RxECB.InUse) { 

IPXRelinquishControl ( ); 
if(kbhitO) { 
getch(); 

RxECB.CCode = Oxfe; 
break; 


if(RxECB.CCode -« 0) { 

printf( "Принят запрос от клиента ’%s'\n", RxBuffer); 
printf ("Для продолжения нажмите любую клавишу\п"); 
getch () I 

memcpy(ClientlmmAddress , RxECB. ImmAddress, 6); 

// Подготавливаем ECB для передачи пакета 

// Попе ImmAddress не заполняем, так как там уже находится адрес 
// станции клиента. Это потому, что мы только что приняли от 
// клиента пакет данных и при этом в ЕСВ установился непосред- 
// стверный адрес станции, которая отправила пакет 

RxECB.Socket = IntSwap(IPXSocket) ; 

RxECB.FragmentCnt —2; 

RxECB.Packet[0].Address = STxHeader; 

RxECB.Packet!0].Size = sizeof(TxHeader); 
RxECB.Packet[l].Address = TxBuffer; 

RxECB.Packet[l].Size = BUFFER_SIZE; 

// Подготавливаем заголовок пакета 
TxHeader.PacketType = 4; 
memset(TxHeader.DestNetwork, 0, 4); 
memcpy(TxHeader.DestNode, RxECB.ImmAddress, 6); 
TxHeader.DestSocket = IntSwap(IPXSocket); 

// Подготавливаем передаваемые данные 

strcpy(TxBuffer, "SPX SERVER *DEMO*"); 

// Передаем пакет обратно клиенту 
IPXSendPacket ( SRxECB ); 

printf( "Связь с сервером установлена\п"); 
printf ("Создаем 8РХ-канал\п\п"); 

// Открываем сокет для работы с протоколом SPX 

if ( IPXOpenSocket ( SHORT_LIVED , SSPXSocket)) { 

printf ("Ошибка при открытии сокета SPX\n" ); 
exit(-l) ; 
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// Подготавливаем ЕСВ для приема пакета 

memset(SLsECB, 0, sizeof(LSECB) ) j 
LsECB.Socket = IntSwap(SPXSocket); 

шешсру (LsECB.ImmAddress, ClientlmmAddress,6); 
LsECB.Fragmentent = 2; 

LsECB.Packet[0].Address = SLsHeader; 

LsECB.Packet(0].Size = sizeof(LsHeader); 
LsECB.Packet[l].Address = RxBuffer; 

LsECB.Packet[l].Size = BOFFER_SIZE; 
SPXListenForSequencedPacket(SLsECB); 

// Подготавливаем заголовок пакета 

ConnHeader.PacketType = 5j 
ConnHeader.TransportControl = 0; 
memset(ConnHeader.DestNetwork, 0, 4); 
шешсру (ConnHeader.DestNode, ClientlmmAddress, 
ConnHeader.DestSocket = IntSwap(SPXSocket); 
memset(sConnECB, 0, sizeof(ConnECB)); 

ConnECB.Socket = IntSwap(SPXSocket); 

ConnECB.FragmentCnt = 1; 

ConnECB.Packet[0].Address = SConnHeader; 
ConnECB.Packet[0].Size = sizeof(ConnHeader) 
// Ожидаем запрос на создание канала 

SPXListenForConnection ( SConnECB ,0,0); 
while(ConnECB.InOse) { 

IPXRelinquishControl(); 
if(kbhit()) { 
getch(); 

ConnECB.CCode = Oxfe; 
break; 


if(ConnECB.CCode == 0) { 

printf( "Канал %04.4X создан\п", 

(unsigned)ConnECB.Connectionld); 

> 

// Ожидаем прихода SPX -пакета от клиента 
while(LsECB.InUse) { 

IPXRelinquishControl(); 
if(kbhit()) { 
getch(); 

LsECB.CCode - Oxfe; 
break; 


if(LsECB.CCode 


0) { 
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printf ("Пакет принят: '%s'\n", RxBuffer); 


// Закрываем сокеты 

IPXCloseSocket ( SlPXSocket): 

XPXCloseSocket(SSPXSocket); 
exit(0): 

> 

Программа-клиент после проверки наличия драйверов IPX и SPX открывает 
два сокета для использования с протоколами IPX и SPX. Затем подготавливает¬ 
ся блок ЕСВ для передачи "широковещательного" пакета по адресу 
FFFFFFFFFFFFh в текущую сеть с номером 000000. На этот пакет должна от¬ 
кликнуться программа-сервер, если она работает в текущей сети. 

После передачи пакета программа-клиент ожидает прихода пакета от серве¬ 
ра. Затем она подготавливает блок ЕСВ для приема SPX -пакета и ставит его в 
очередь на прием при помощи функции SPXListenForSequencedPacket(). 

Затем программа-клиент подготавливает блок ЕСВ для создания канала с 
программой-сервером и вызывает функцию создания канала с передающей сто¬ 
роны SPXEstablishConnection(). 

После того, как канал будет создан, в область памяти ConnID копируется 
идентификатор канала для использования при приеме и передаче SPX -пакетов. 

Далее программа-клиент подготавливает SPX -пакет и блок ЕСВ для передачи прог¬ 
рамме-серверу и при помощи функции SPXSendSequencedPacketO передает пакет. 

После передачи SPX -пакета программа-клиент закрывает оба сокета и за¬ 
вершает свою работу. 

// - -—- - --” 

// Листинг 13. Клиент SPX 
П 

// Файл spxclien.c 
// 

// (С) A. Frolov, 1993 

// --=---======-- 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include “lpx.h" 

♦include “spx.h" 

// Максимальный размер буфера данных 
♦define BUFFER_SIZE 512 
void main(void) { 


"ДИАЛОГ -Л 










78 


Локальные 


персональных компьютеров 


II Будем работать с сокетом 0x4567 

static unsigned IPXSocket = 0x4567; 
static unsigned SPXSocket = 0x4568; 

II ECB для приема и передачи пакетов 
struct ECB RxECB, ТхЕСВ; 
struct ECB ConnECB, LsECB, SndECB; 

// Заголовки принимаемых и передаваемых пакетов 
struct IPX_HEADER RxHeader, TxHeader; 
struct SPX_HEADER COnnHeader, LsHeader, SndHeader; 
// Буферы для принимаемых и передаваемых данных 
unsigned char RxBuffer[BUFFER_SIZE] ; 
unsigned char TxBuffer[BUFFER_SIZE]; 
struct SPXParams Params; 
unsigned char ServerlmmAddress[6]; 
unsigned MyConnID, ConnXD; 
unsigned rc; 

printf(" \п*Клиент SPX*, (С) Фролов A., 1993\n\n"); 
// Проверяем наличие драйвера IPX и определяем 
// адрес точки входа его API 
if (ipx^init( ) '=. Oxff) { 

printf("IPX не загружен !\n"); exit(-l); 

} 

iff SPXCheckSPXInstallation(SParams) != OxFF) { 
printf("SPX не загружен! \n" ); exit(-l); 

> 

// Открываем сокет, на котором мы будем 
II принимать и передавать пакеты 

if ( IPXOpenSocket ( SHORT_LIVED , S IPXSocket)) { 
printf ( "Ошибка при открытии сокета\п"); 
exit (-1); 

>; 

// Открываем сокет для протокола SPX 

if(IPXOpenSocket(SHORT_LIVED, SSPXSocket) ) { 

printf( "Ошибка при открытии сокь. . SPX\n"); 
exit(-l); 


// Подготавливаем ECB для передачи пакета 
memsetfSTxECB, 0, sizeof (ТхЕСВ)); 

ТхЕСВ. Socket = IntSwapfIPXSocket) ; 

ТхЕСВ .FragmentCnt = 2; 

ТхЕСВ. Packet[0].Address = STxHeader; 

ТхЕСВ .Packet[0].Size = sizeof(TxHeader) ; 
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TxECB.Packet(l).Address = TxBuffer; 
TxECB.Packet(l).Size = BUFFER_SIZE; 

// Пакет предназначен всем станциям данной сети 
memset(TxECB.IiranAddress , Oxff, 6); 

// Подготавливаем заголовок пакета 
TxHeader . PacketType - 4; 
memset ( TxHeader.DestNetwork, 0, 4); 
memset(TxHeader.DestNode, Oxff, 6); 

TxHeader.DestSocket = IntSwap(IPXSocket); 

// Записываем передаваемые данные 

strcpy(TxBuffer, "CLIENT *DEMO*”)! 

// Передаем пакет всем станциям в данной сети 
i IPXSendPacket(STxECB) ; 

// подготавливаем ЕСВ для приема пакета от сервера 
memset(SRxECB, 0, sizeof(RxECB)); 

RxECB.Socket = IntSwap(IPXSocket); 

RxECB.FragmentCnt = 2; 

RxECB.Packet[0].Address = SRxHeader; 

RxECB.Packet)0).Size = sizeof(RxHeader)j 
RxECB.Packet[l].Address = RxBuffer; 

RxECB.Packet[l].Size = BUFFER_SIZE; 
IPXListenForPacket(SRxECB); 
printf ("Ожидание ответа от сервера\п"); 
printf("flnH отмены нажмите любую клавишу\п"); 
II Ожидаем прихода ответа от сервера 
while(RxECB.InUse) { 

IPXRelinquishControl ( )j 
if(kbhit()) { 
getch()? 

RxECB.CCode = Oxfe; 
break; 


if(RxECB.CCode — 0) { 

printf( "Принят ответ от сервера ’%s’\n" , RxBuffer); 

} 

// Копируем сетевой адрес сервера 

meracpy(ServerImmAddress , RxECB.ImmAddress, 6); 

И Подготавливаем ЕСВ для приема пакета 
memset(SLsECB, 0, sizeof(LsECB) ); 

LsECB.Socket = IntSwap(SPXSocket); 

memcpy (LsECB. IiranAddress, Server IiranAddress, 6); 

LsECB.FragmentCnt =2; 
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LsECB.Packet!0].Address = SLsHeader; 

LsECB.Packet[0].Size = sizeof(LsHeader); 

LsECB.Packet[1]-Address = RxBuffer; 

LsECB.Packet[l].Size = BUFFER_SIZE; 
SPXListenForSequencedPacket(SLsECB); 

// Подготавливаем заголовок пакета 
ConnHeader.PacketType =5; 

ConnHeader.TransportControl = 0; 

memset(ConnHeader.DestNetwork, 0, 4); 

raeracpy(ConnHeader.DestNode, ServerIramAddress, 6); 

ConnHeader.DestSocket = IntSwap(SPXSocket); 

memset(SConnECB, 0, sizeof(ConnECB ))} 

ConnECB.Socket = IntSwap(SPXSocket); 

ConnECB.FragmentCnt = 1; 

ConnECB.Packet!0].Address = SConnHeader; 

ConnECB.Packet!0].Size = sizeof(ConnHeader); 

// Устанавливаем SPX -канал с сервером 

rc = SPXEstablishConnection(SConnECB, SMyConnID, 0, 0}; 
printf( "Ожидание SPX -соединения с сервером\п" ); 
printf ("Для отмены нажмите любую клавишу\п" ); 
if ( rc — 0) { 

while!ConnECB•InUse) { 

IPXRelinquishControl( )} 
if(kbhit()) { 
getch(); 

ConnECB.CCode = Oxfe; 


// Копируем идентификатор канала для передачи пакета в сервер 
memepy ( SConnID, S(ConnHeader.SourceConnID ) , 2 ); 
printf( "Канал с сервером установлен, ConnID=%d\n", 
IntSwap(ConnlD)); 

// Подготавливаем ECB для передачи SPX -пакета 
memset(SSndECB, 0, sizeof(SndECB))) 

SndECB.Socket = IntSwap(SPXSocket); 

SndECB.FragmentCnt = 2; 

SndECB.Packet!0].Address = SSndHeader; 

SndECB.Packet[0].Size = sizeof(SndHeader); 
SndECB.Packet[l].Address = TxBufferj 
SndECB.Packet[l].Size = BOFFER_SIZE; 
memepy(SndECB.ImmAddress, ServerlmmAddress, 6); 

// Подготавливаем заголовок пакета 
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SndHeader.PaoketType = 5; 

memset(SndHeader.DestNetwo’rk, 0, 4); 

memcpy(SndHeader.DestNode, ServerlmmAddress, 6); 

SndHeader.DestSocket = IntSwap(SPXSocket)j 
SndHeader.TransportControl = 0; 

SndHeader.DataStreamType = 1; 

// Записываем передаваемые данные 

strcpy(TxBuffer, "SPX/CLIENT *DEMO*")f 
// Передаем SPX -пакет 

SPXSendSequencedPacketfSSndECB, ConnID); 

// Закрываем сокеты 

IPXCloseSocket(SlPXSocket); 

IPXCloseSocket( bSPXSocket); 
exit(0); 

} 

В файле spx.c определены функции для работы с протоколом SPX (листинг 14): 

// Листинг 14. Функции SPX . 

// 

// Файл spx.c 

// 

// (С) A. Frolov, 1993 

И =-============--------~ 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include "ipx.h" 

♦include "spx.h" 


* .Name SPXCheckSPXInstallation 

* .Title Проверить присутствие протокола SPX 

* .Descr Функция проверяет, загружен ли драйвер SPX 

* и возвращает его параметры. 


* .Params struct *SPXParams - указатель на структуру, 

* в которую будут записаны параметры SPX. 

* .Return FFh - протокол SPX загружен 

* 00h - протокол SPX не загружен 
**/ 

int SPXCheckSPXInstallation(struct SPXParams «Params) { 
struct IPXSPX_REGS iregs; 
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iregs.bx = SPX_CMD_INSTALL_CHECK; 
iregs.ax = 0; 

ipxspx_entry( (void far *)Siregs ); 
Params->SPXVersion = iregs.bx; 
Params->SPXMaxConnections = iregs.cx; 
Params->SPXAvailableConnCount = iregs.dx; 
return)iregs.ax & OxFF); 



.Name SPXListenForConnection 

•Title Ожидание соединения с клиентом 

•Descr . Функция выдает запрос на соединение 

с клиентом, который должен для выполнения 
соединения вызвать функцию SPXEstablishConnection( ) . 

. Params struct ЕСВ *ConnECB - указатель на ЕСВ, 

заполненное для установления соединения, 
unsigned char RetryCount - счетчик повторов; 
unsigned char WatchdogFlag - проверка связи. 


* .Return Ничего. 

**/ . 

void SPXListenForConnection(struct ЕСВ «ConnECB, 

unsigned char RetryCount, unsigned char WatchdogFlag) { 

struct IPXSPX_REGS iregs; 

iregs.bx = SPX_CMD_LISTEN_FOR_CONNECTION; 

iregs.ax = RetryCount | 

((Unsigned)(WatchdogFlag « 8) & OxffOO); 
iregs.es = FP_SEG((void far*)ConnECB); 
iregs.si « FP_OFF((void far*)ConnECB); 
ipxspx_entry( (void far *)siregs ); 

> 

/** 

* .Name SPXEstablishConnection 


•Title Установление соединения с клиентом 

.Descr Функция устанавливает соединение 

с клиентом, который должен для выполнения 
соединения вызвать функцию SPXListenForConnection (). 


.Params struct ЕСВ *ConnECB - указатель на ЕСВ, 

заполненный для установления соединения, 
unsigned char RetryCount - счетчик повторов; 
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* unsigned char WatchdogFlag - проверка связи. 

* .Return Ничего. 

int SPXEstablishConnection(struct ECB ‘ConnECB, unsigned *ConnID, 
unsigned char RetryCount, unsigned char WatchdogFlag) { 
struct IPXSPX_REGS iregs; 
iregs.bx = SPX_CMD_ESTABLISH_CONNECTIQN; 
iregs.ax = RetryCount | 

((unsigned)(WatchdogFlag « 8) & OxffOO); 
iregs.es = FP_SEG((void far*)ConnECB); 
iregs.si = FP_OFF((void far*(ConnECB); 
ipxspx_entry( (void far *)Siregs ); 

*ConnID = iregs.dx; 
return(iregs.ax & Oxff); 

} 

* .Name SPXListenForSequencedPacket 

* .Title Прием пакета SPX 

* .Descr Функция выдает запрос на прием пакета SPX. 


* .Return Ничего. 

void SPXListenForSequencedPacket ( struct ECB *LsECB) { 
struct IPXSPX_REGS iregs; 

iregs.bx = SPX_CMD_LISTEN_FOR_SEQUENCED_PACKET; 
iregs.es = FP_SEG((void far*)LsECB); 
iregs.si = FP_OFF((void far* )LsECB)'; 
ipxspx_entry( (void far *)Siregs ); 


} 


■ .Name SPXSendSequencedPacket 

1 .Title Передача пакета SPX 


' .Descr Функция выдает запрос на передачу пакета SPX. 
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* .Return Ничего. 

void SPXSendSequencedPacket(struct ЕСВ *ТхЕСВ, unsigned ConnID) { 
struct IPXSPX_REGS iregs; 
iregs.bx - SPX_CMD_SEND_SEQUENCED_P АСКЕТ; 
iregs.es = FP_SEG((void far*)TxECB); 
iregs.si - FP_OFF((void far*)TxECB); 
iregs.dx - ConnID; 

ipxspx_entry( (void far *)&iregs ); 

> 

В файле spx.h (листинг 15) определены константы, структуры данных и про¬ 
тотипы функций для работы с протоколом SPX: 

//---- - - --—— 

// Листинг 15. Include -файп для работы с SPX 
// Файл spx.h 
// 

// (С) A. Frolov, 1992 

//------ - - -- - -- " 

♦include <dos.h> 

♦include <string.h> 

♦include <stdio.h> 

♦include <stdlib.h> 

// .. 

// Команды интерфейса SPX 
// --- 


♦define SPX_CMD_INSTALL_CHECK 0x10 
♦define SPX_CMD_ESTABLISH_CONNECTION 0x11 
♦define SPX_CMD_LISTEN_FOR_C0NNECTION 0x12 
♦define SPX_CMD_TERMINATE_CONNECTION 0x13 
♦define SPX_CMD_ABORT_CONNECTION 0x14 
♦define SPX_CMD_GET_CONNECTION_STATUS 0x15 
♦define SPX_CMD_SEND_SEQUENCED_P АСКЕТ 0x16 


♦define SPX_CMD_LISTEN_FOR_SEQUENCED_P АСКЕТ 0x17 

struct SPXParams { 

unsigned SPXVersion; 
unsigned SPXMaxConnections; 
unsigned SPXAvailableConnCount; 

>! 

// Заголовок пакета SPX 

struct SPX_HEADER { 

unsigned int Checksum; 

unsigned int Length; 
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unsigned char TransportControl; 

unsigned char PacketType; 

unsigned char DestNetwork[4]; 

unsigned char DestNode[6]j 

unsigned int DestSocket; 

unsigned char SourceNetwork[4]; 

unsigned char SourceNode[6]; 

unsigned int SourceSocket; 

- Специфическая для SPX часть - 

unsigned char ConnControl; 
unsigned char DataStreamType; 
unsigned char SourceConnID[2]; 
unsigned char DestConnID[2]; 
unsigned char SequenceNumber[2]; 
unsigned char AckNumber[2]; 
unsigned char AllocationNumber[2]; 


int SPXCheckSPXInstallation(struct SPXParams *Params); 
void SPXListenForConnection(struct ECB *ConnECB, 

unsigned char RetryCount, unsigned char WatchdogFlag); 
int SPXEstablishConnection(struct ECB ‘ConnECB, unsigned *ConnID, 
unsigned char RetryCount, unsigned char WatchdogFlag); 
void SPXListenForSequencedPacket(struct ECB *LsECB); 
void SPXSendSequencedPacketf struct ECB *TxECB, unsigned MyConnID) ; 


3.5. Настройка параметров SPX 

В разделе, посвященном настройке параметров драйвера IPX, мы говорили о 
том, что при запуске программы ipxodi.com можно указьшать параметры. Если 
указывается параметр "d", на рабочей станции не загружается диагностический 
сервис. Если же указывается параметр "а", в память не загружаются драйвер 
протокола SPX и диагностический сервис. 

В документации на вашу программу следует указать о том, какие параметры 
можно использовать при загрузке ipxodi.com. В частности, если ваша прог¬ 
рамма использует протокол SPX, параметр "а" задавать нельзя. 

Для изменения режима работы драйвера SPX в первых строках файла net.cfg, 
расположенного в каталоге C:\NET (см. предыдущий том "Библиотеки 
системного программиста"), можно указывать параметры: 

SPX ABORT TIMEOUT Время в тиках системного таймера, в течение кото¬ 
рого драйвер SPX будет ожидать прихода ответа от 
партнера по каналу, прежде чем будет сделан вывод о 
невозможности работы с каналом. После истечения 
этого времени канал будет закрыт. 

По умолчанию драйвер ждет 540 тиков, что соответ¬ 
ствует примерно 30 с. 
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SPX CONNECTIONS Параметр определяет максимальное количество кана¬ 
лов, которые могут быть созданы на рабочей станции. 
По умолчанию можно создавать максимально 15 
каналов. 

SPX LISTEN TIMEOUT Параметр задает время, в течение которого драйвер 

SPX будет ждать прихода пакета от партнера. Если за 
это время пакет не придет, драйвер будет посылать 
пакеты для проверки работоспособности канала. 

По умолчанию это время равно 108 тикам, что со¬ 
ставляет примерно 6 с. 

SPX VERIFY TIMEOUT Этот параметр задает период времени, с которым 

драйвер SPX передает пакеты для проверки работо¬ 
способности канала связи. 

По умолчанию проверочные пакеты передаются с ин¬ 
тервалом 54 тика (примерно 3 с). 

Например, для увеличения числа доступных каналов до 25 добавьте в начало 
файла net.cfg строку: 

SPX CONNECTIONS** 2 5 




Глава 4 

ПРОТОКОЛ NETBIOS 

Последний протокол, который мы рассмотрим в нашей книге, - протокол NETBIOS 
(Network Basic Input/Output System - базовая сетевая система ввода/вывода), разрабо¬ 
танный ГОМ. Этот протокол работает на трех уровнях семиуровневой модели OSI: се¬ 
тевом уровне, транспортном уровне и на уровне каналов связи. Уровень каналов связи 
обеспечивает механизм обмена сообщениями между программами, работающими на 
станциях в рамках канала связи или сессии. NETBIOS может обеспечить интерфейс 
более высокого уровня, чем протоколы IPX и SPX. 

Протокол NETBIOS поддерживается в сетях IBM (IBM PC LAN), Novell NetWare, 
Microsoft Windows for Workgroups и в друшх сетях. К сожалению, нет единого стан¬ 
дарта на протокол NETBIOS, поэтому в сетевом программном обеспечении разных 
фирм используются разные интерфейсы для вызова команд NETBIOS. 

С нашей точки зрения, наибольший интерес представляет применение 
NETBIOS в сетях Novell NetWare и Microsoft Windows for Workgroups. Мы рас¬ 
смотрим основные возможности NETBIOS, связанные с передачей данных меж¬ 
ду рабочими станциями в пределах одного логического сегмента сети. 

Для работы с протоколом NETBIOS в сетях Novell NetWare необходимо за¬ 
пустить специальный эмулятор NETBIOS - программу netbios.exe, входящую в 
комплект поставки Novell NetWare. Эта программа эмулирует протокол 
NETBIOS с использованием уже знакомых нам протоколов IPX/SPX. 

Использовать NETBIOS проще, чем IPX или SPX. Однако, так как в среде 
Novell NetWare нужен специальный эмулятор NETBIOS, эффективность работы 
программы может снизиться. Кроме того, для эмулятора нужна дополнительная 
память, так как он реализован в виде резидентной программы. 

4.1. Адресация станций и программ 

Как вы помните, для идентификации рабочей станции протоколы IPX и SPX 
используют номер сети, адрес станции в сети и сокет. Адрес станции определя¬ 
ется на аппаратном уровне и представляет собой число длиной 6 байт. Номер 
сети занимает 4 байта. Сокеты выделяются динамически драйвером протокола 
IPX или могут быть получены в Novell. 

Протокол NETBIOS использует другой механизм адресации станций и прог¬ 
рамм. Для адресации станции используются имена размером 16 байт. Каждая 
станция имеет одно постоянное имя (permanent name), которое образуется из 
аппаратного адреса добавлением к нему слева десяти нулевых байт. Кроме посто¬ 
янного имени протокол NETBIOS позволяет добавлять (и удалять) обычные имена 
и групповые имена. Обычные имена служат для идентификации рабочей станции, 
групповые могут служить для посылки пакетов одновременно нескольким станциям 
в сети. Постоянное имя удалить нельзя, так как оно полностью определяется 
аппаратным обеспечением станции. 
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При добавлении обычного имени протокол NETBIOS опрашивает всю сеть 
для проверки уникальности имени. Групповое имя может быть одинаковое на 
нескольких станциях, поэтому при добавлении группового имени опрос сети 
не выполняется. 

После добавления нового имени этому имени присваивается так называемъ 
номер имени (name number), который используется для передачи данньос по се™- 
Сравнивая методы адресации, используемые протоколами IPX/SPX и NETBIOS, 
нетрудно заметить, что метод адресации протокола NETBIOS более удобен. Вы 
можете адресовать данные не только одной станции (как в IPX и SPX) или всем 
станциям сразу (как в IPX), но и группам станций, имеющим одинаковое группо¬ 
вое имя. Эго может быть удобно, если в сети работают несколько групп пользова¬ 
телей, которые интенсивно обмениваются данными между собой. 

Другим преимуществом схемы адресации протокола NETBIOS перед схемой 
адресации протоколов IPX/SPX можно считать отсутствие необходимости полу¬ 
чать в фирме Novell свой собственный номер сокета для идентификации вашего 
программного обеспечения. Вы можете придумать свое собственное уникальное 
групповое имя, включающее, например, название программы и вашей фирмы, и 
использовать его для работы по схеме клиент-сервер. 

4.2. Работа с протоколом NETBIOS 

Протокол NETBIOS предоставляет программам интерфейс для передачидан¬ 
ных на уровне датаграмм и на уровне каналов связи. Для вызова NETBIOS 
программа должна создать в памяти управляющий блок, который называется 
NCB (Network Control Block - сетевой управляющий блок). Адрес заполненного 
блока NCB передается прерыванию INT 5Ch, в рамках которого и реализован 
интерфейс протокола NETBIOS. Есть также альтернативный интерфейс, реали¬ 
зованный в рамках прерывания INT 2Ah, который поддерживается эмулятором 
NETBIOS, разработанным фирмой Novell, а также операционной системой 
Windows for Workgroups версии 3.1. 

4.2.1. Проверка присутствия NETBIOS 

Первое, что должна сделать программа, желающая воспользоваться протоко¬ 
лом NETBIOS, - проверить наличие в системе интерфейса NETBIOS. 

Ниже приведена программа, которая определяет, установлен ли драйвер NETBIOS. 

С помощью функции getvect() программа получает указатель ^обработчик 
прерывания INT 5Ch. Это прерывание используется для вызова NETBIOS. Если 
сегментная компонента адреса равна нулю или FOOOh, обработчик прерывания 
не установлен или установлена заглушка, расположенная в BIOS. В этом случае 
программа считает, что NETBIOS отсутствует. 
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// Листинг 16. Проверка присутствия NETBIOS 

// 

// Файл nbver.cpp 

И 

// (С) А. Frolov, 1993 

//- - - ™=====--- 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 
void main(void) { 

void interrupt ( *int5C)(...); 

printf("Check if NETBIOS is installed\n"); 

int5C = getvect(0x5c); 

if(FP_SEG(int5C) == 0x0000 || FP_SEG(int5C) == OxFOOO) { 
printf("NETBIOS NOT installed.\n")j 

} 

else printf("NETBIOS is installed!\n“); 

} 

Другой способ проверки наличия интерфейса NETBIOS заключается в вызове 
прерывания INT 2Ah. Загрузите в регистр АН нулевое значение и вызовите 
прерывание INT 2Ah. Если после возврата из прерывания в регистре АН 
попрежнему находится нуль, драйвер NETBIOS не установлен. 

Данньгіі способ проверки будет работать на виртуальной машине DOS, запу¬ 
щенной в среде Windows for Workgroups версии 3.1 (если Windows работает в 
расширенном режиме). 

Приведенная ниже программа определяет присутствие NETBIOS с помощью 
вызова прерывания INT 2 Ah (листинг 17): 

П Листинг 17. Проверка присутствия NETBIOS 

// с использованием интерфейса INT 2Ah 

И 

U Файл 2atest.cpp 

4 ' 

U (С) A. Frolov, 1993 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

: ДИАЛОГ-МИФИ • 
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s installed\n " )} 


void main(void) { 

union REGS regs; 
printf("Check if NETBIOS J 
regs.h.ah “ 0; 
int86(0x2a, sregs, &regs); 
if(regs.h.ah -- 0) { 

printf("NETBIOS NOT installed.\n' )i 

else printf("NETBIOS is installed I\n"); 

Прерывание INT 2Ah используется в сетях фирм Microsoft и Lantastic. Эму¬ 
лятор протокола NETBIOS, поставляющийся фирмой Novell вместе с операци¬ 
онной системой Novell NetWare, поддерживает как интерфейс прерывания 
INT 5Ch, так и интерфейс INT 2Ah. 

4.2.2. Вызов команд протокола NETBIOS 

Интерфейс протокола NETBIOS реализован в рамках прерывания INT 5Ch 

или INT 2Ah и очень прост. ыт ія 

Д м вызова команд протокола NETBIOS вам достаточно подготовить блок NCB, за- 
гоѵзить его дальний адрес в регистры ES:BX и вызвать прерывание ЮТ 5Ch. 
^Приведем формат вызова функции прерывания INT 2Ah, предназначенной 
для выполнения команд NETBIOS: 

На входе. А^ _ Признак автоматического повтора команды при полу¬ 
чении кодов ошибки 09h (недостаточно ресурсов), 12h 
(создание канала отвергнуто, так как на другом конце 
не выдана команда NB_Listen), 21h (занят интерфейс). 

00h - повторять команду; 

FFh - не повторять команду. 

ES-.BX = Адрес заполненного блока NCB. 

На выходе: АН = Код завершения: 

00h - команда выполнилась без ошибок; 

Olh - при выполнении команды были ошибки. 

AL = Если содержимое регистра АН после возврата из пре- , 
рывания не равно нулю, регистр AL содержит код 
ошибки 

Вы можете использовать описанный выше вызов прерывания 2А Дта «и, 
зова NETBIOS из программы, работающей на виртуальной машине Windows for 

W °£ вЗвГкоманд^‘протокола NETBIOS из пограммЫ, составленной ™ языке 
Си, вы можете воспользоваться обычными средствами вызова программных 
прерываний, такими, как функция int86x(). 
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4.2.3. Формат блока NCB 

Приведем формат блока NCB: 
struct _ncb { 

unsigned char Cmd; 

unsigned char CCode; 

unsigned char LocalSessionNumber; 

unsigned char NetworkNameNumber; 

void far ‘Buffer; 

unsigned Size; 

char CallName)16]; 

char 0urName[16); 

unsigned char ReceiveTimeout; 

unsigned char SendTimeout; 

void interrupt (‘PostRoutine)(void); 

unsigned char AdapterNumber; 

unsigned char FinalCCode; 

unsigned char Reserved) 14]-; 

>; 

Поле Cmd содержит код команды, которую необходимо выполнить. Суще¬ 
ствуют команды для работы с именами станций, для передачи и приема дата- 
грамм, для работы на уровне каналов и некоторые другие. Мы пассмотрим 
команды NETBIOS в следующем разделе. 

Поле CCode содержит код ошибки, возвращаемый NETBIOS до выполнения 
команды. Если, например, программа затребовала выполнение неправильной 
команды или задала для команды неправильные параметры, NETBIOS не будет 
выполнять такую команду и установит в поле CCode соответствующий код 
ошибки. Если же в этом поле после вызова NETBIOS находится нулевое значе¬ 
ние, это еще не означает, что команда выполнилась правильно, однако она на¬ 
чала выполняться. 

Поле LocalSessionNumber содержит номер канала, установленного с другой 
программой. Это поле необходимо заполнять при выдаче команд передачи дан¬ 
ных через каналы. 

Поле NetworkNameNumber содержит номер имени, который присваивается 
при добавлении обычного или группового имени. Это поле должно быть запол¬ 
нено при приеме датаграмм. 

Поле Buffer представляет собой дальний указатель в формате [сегментхмещение] на 
буфер, который должен содержать данные перед выполнением передачи или на буфер, 
который будет использован для приема данных. 

Размер буфера, используемого для приема или передачи данных, определяет¬ 
ся содержимым поля Size. 

Поле CallName заполняется именем станции, с которой ваша станция желает 
установить канал для передачи данных. 

“ДИАЛОГ-МИФИ" 
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Поле OurName должно содержать имя вашей программы, под которым она 
будет принимать данные. В качестве этого имени может выступать обычное, 
групповое или постоянное имя. 

Поля ReceiveTimeout и SendTimeout содержат интервал времени (измеряе¬ 
мый в 1/2 с), в течение которого ожидается завершение соответственно команд 
приема и передачи. 

Поле PostRoutine - указатель на программу, которая получает управление 
после завершения команды. Эта программа (POST -программа) аналогична прог¬ 
рамме ESR протоколов IPX/SPX и вызывается только в том случае, если в поле 
PostRoutine был указан адрес программы. Если же это поле заполнить нулями, 
никакая программа вызываться не будет. 

Поле AdapterNumber используется, если в станции установлено несколько 
сетевых адаптеров (в сетях Ethernet этого обычно не бывает). В этом поле ука¬ 
зывается номер адаптера, для которого предназначена команда. Первый адаптер 
имеет номер 0, второй - 1. 

Поле FinalCCode содержит во время выполнения команды значение OxFF. 
После завершения выполнения команды в это поле записывается код ошибки, 
который относится к выполнению команды в целом (в отличие от кода в поле 
CCode). Если ваша программа не задала адрес для программы в поле 
PostRoutine, она должна опрашивать в цикле содержимое этого поля, ожидая, 
пока в нем не появится значение, отличное от OxFF. 

Поле Reserved зарезервировано для использования протоколом NETBIOS, 
ваша программа не должна изменять его содержимое. 

4.2.4. POST -программа 

POST -программа является программой обработки прерывания. Она получает, 
управление в состоянии с запрещенными прерываниями. Регистры ES:BX со¬ 
держат адрес блока NCB, который использовался при выполнении команды. 
В регистр AL записано значение из поля FinalCCode блока NCB. 

Учтите, что, как и из любой другой программы обработки прерывания, из 
POST -программы не следует вызывать функции MS-DOS. 

Требования к POST -программе во многом такие же, как и к ESR -программе,, 
используемой протоколами IPX и SPX. Она должна позаботиться о сохранении 
изменяемых регистров, установить регистр DS на сегмент данных программы 
(для обеспечения доступа к переменным). POST -программа должна работать 
как можно быстрее. Лучше всего если она будет использоваться только для 
установки флага, сигнализирующего основной программе о завершении выполз 
нения команды. 

Перед завершением своей работы POST -программа должна восстановить со-; 
держимое всех регистров и выполнить команду возврата из прерывания IRET. 
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Если вы составляете POST -программу на языке программирования Си, вы 
можете воспользоваться ключевым словом interrupt- 
void interrupt NETBIOS_Post_Routine(void) ; 

Лучше всего составить POST -программу на языке ассемблера, например, так: 
.286 

.MODEL SMALL 
• DATA 

_completed_ncb_ptr dd 0 

.CODE 

PUBLIC _netbios_post 
PUBLIC _completed_ncb_ptr 
_netbios_post PROC FAR 
push ax 
push ds 

mov ax, DGROUP 
mov ds, ax 

mov word ptr _completed_ncb_ptr+2, es 

mov word ptr _completed_ncb_ptr, si 

pop si 

pop es 

pop ds 

pop ax 

iret 

_netbios_post ENDP 


4.3. Команды NETBIOS 

Перед выполнением команды ее код должен быть записан в поле Cmd блока 
NCB. Каждая команда NETBIOS реализована в двух вариантах - с ожиданием и 
без ожидания. 

Если вашей программе нечего делать до тех пор, пока выполнение команды 
NETBIOS не будет полностью завершено, вы можете выбрать вариант с ожида¬ 
нием. В этом случае после вызова NETBIOS программа вновь получит управле¬ 
ние только после завершения выполнения команды. При использовании прото¬ 
колов IPX/SPX ваша программа должна была сама дожидаться выполнения 
вызванной функции, выполняя в цикле опрос поля InUse блока ЕСВ. Однако 
учтите, что, если по каким-либо причинам выполнение команды не может быть 
завершено, ваша программа "зависнет". 
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Вариант без ожидания похож на вариант использования функций 1PX/SPX с 
программой ESR, вызываемой после завершения операции. Программа, вызвавшая ко¬ 
манду NETBIOS без ожидания, получает управление немедленно. Команда будет вы¬ 
полняться в фоновом режиме параллельно с работой вызвавшей ее программы. После 
того как выполнение команды будет завершено, управление будет передано функции, 
адрес которой необходимо указать в поле PostRoutine блока NCB. Можно также 
дожидаться окончания выполнения команды, опрашивая в цикле поте FinalCCode, 
которое будет содержать значение OxFF до тех пор, пока команда не будет выполнена. 

Все команды NETBIOS можно разделить на несколько групп: 

• для работы с именами; 

• для прггема и передачи датаграмм; 

• для работы с каналами; 

• для приема и передачи данных через каналы; 

• другие команды. 

Так как большинство команд NETBIOS реализованы в двух вариантах 
(с ожиданием и без ожидания), для обозначения варианта с ожиданием мы 
будем в названии команды после префикса NB_ (от слова NETBIOS) добавлять 
букву W (от слова wait - ожидание). Например, команда NB_AddName 
выполняется без ожидания, а команда NB_WAddName - с ожиданием. 

У команд без ожидания старший бтгт кода команды установлен в единицу. 

4.3.1. Работа с именами 

В этой группе есть команды, позволяющие добавлять обычное или групповое 
имя, удалять имя. Все эти команды могут работать в двух вариантах - с ожида¬ 
нием и без ожидания. 

NBJVAddName (0x30) 

Команда добавляет указанное в поле OurName имя в таблицу имен, располо¬ 
женную на рабочей станции. Имя должно быть уникальным в сети. Оно не мо¬ 
жет использоваться на других станциях ни как обычное, ни как групповое. 

Если длина имени меньше 16 байт, оно должно быть дополнено справа сим¬ 
волами пробела. Можно закрыть имя двоичным нулем для совместимости со 
строками языка Си. Нуль должен находиться в последней позиции имени. 

После успешного выполнения команды NETBIOS присваивает имени номер 
и возвращает его в поле LocalSessionNumber блока NCB. Номер имени может 
потребоваться вам для работы с датаграммами. 

В процессе добавления имени NETBIOS посылает по сети запрос. Если такое 
имя уже используется на какой-либо станции, эта станция пришлет ответ. 
В этом случае команда завершиться с ошибкой и имя добавлено не будет. 

Процедура добавления имени занимает достаточно много времени. Это связа¬ 
но с необходимостью выполнить опрос всех станций сети. Поэтому вы должны 
добавлять имена один раз в самом начале работы программы. 
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Поля NCB на входе 

Содержимое 

Cmd 

OurName 

PostRoutine 

0x30 

Добавляемое имя 

Дальний указатель на POST -программу или нулевое 

AdapterNumber 

значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, .1 - второй 


Поля NCB на выходе 

Содержимое 

NetworkNameNumber 

CCode 

FinalCCode 

Присвоенный номер имени 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x03 

0x09 

0x0D 

ОхОЕ 

0x15 

0x16 

0x19 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Нет доступных ресурсов 

Указанное команде имя уже используется на этой станции 
Переполнение таблицы имен 

Неправильное имя 

Имя уже используется на одной из рабочих станций в сети 
Конфликт имен (внутренняя ошибка NETBIOS) 
Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 
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NB_AddName (ОхВО) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВО. 

NB_WAddGroupName (0x36) 

Команда добавляет указанное в поле OurName групповое имя в таблицу 
имен, расположенную на рабочей станции. 

Имя не должно использоваться другими станциями в сети как обычное. Од¬ 
нако несколько станций могут использовать одно и тоже имя как групповое. 

Если длина имени меньше 16 байт, оно должно быть дополнено справа сим¬ 
волами пробела. Можно закрыть имя двоичным нулем для совместимости со 
строками языка Си. Нуль должен находиться в последней позиции имени. 

После успешного выполнения команды NETBIOS присваивает имени номер 
и возвращает его в поле LocalSessionNumber блока NCB. Номер имени нужен 
для работы с датаграммами. 


Поля NCB на входе 

Содержимое 

Cmd 

OurName 

PostRoutine 

AdapterNumber 

0x36 

Добавляемое групповое имя 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

NetworkNameNumber 

CCode 

FinalCCode 

Присвоенный номер имени 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 
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Содержимое поля Значение 

FinalCCode на выходе 

0x00 Нет ошибок 

0x03 Неправильный код команды 

0x09 Нет доступных ресурсов 

0x0D Указанное команде имя уже используется на этой 

станции 

0х0Е Переполнение таблицы имен 

0x15 Неправильное имя 

0x16 Имя уже используется на одной из рабочих станций 

в сети 

0x19 Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 Интерфейс занят 

0x22 Выдано слишком много команд 

0x23 Неправильное значение в поле номера адаптера 

AdapterNumber 

0x40 - 0x4F Необычное состояние сети (Unusual network condition) 

0x50 - OxFE Сбой сетевого адаптера или другого сетевого аппа¬ 

ратного обеспечения 


NB_AddGroupName (ОхВб) 

Команда аналогична предыдущёй, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВб. 

NBJVDeleteName (0x31) 

Команда удаляет имя из таблицы имен рабочей станции, если оно не исполь¬ 
зуется каким-либо каналом. Если же имя используется каналом, то оно помеча¬ 
ется как назначенное для удаления и удаляется после закрытия канала. 

Если вы попытаетесь удалить имя, которое используется каналом, команда 
завершится с кодом ошибки OxF. В этом случае перед удалением имени необ¬ 
ходимо закрыть канал (см. дальше описание команд для работы с каналами). 
Как только канал будет закрыт, связанное с ним имя будет автоматически уда¬ 
лено, если перед закрытием канала выполнялась попытка удалить имя. 

Если имя используется несколькими каналами, его можно удалить только 
после закрытия всех связанных с ним каналов. 


Поля NCB на входе Содержимое 

Cmd 0x31 

OurName Удаляемое имя 

PostRoutine Дальний указатель на POST -программу или нулевое 

значение, если POST -программа не используется 
AdapterNumber Номер адаптера; 0 - первый адаптер, 1 - второй 

■ДИАЛОГ-МИФИ' 
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Поля NCB на выходе 

Содержимое 


CCode 

FinalCCode 

Промежуточный к 
Окончательный кс 

од завершения команды 
щ завершения команды 


Содержимое поля CCode 

Значение 



0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля Значение 

FinalCCode на выходе 


0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x0F 

Имя используется каналом. Немедленное удаление имени 


невозможно, однако оно отмечено как назначенное для 


удаления и будет удалено после закрытия канала 

0x15 

Неправильное имя 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 


AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_DeleteName (ОхВІ) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВІ. 


4.3.2. Прием и передача датаграмм 

С помощью команд приема и передачи датаграмм вы можете передавать и 
принимать пакеты без подтверждения, аналогично тому, как это выполняет 
протокол IPX. 
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Есть команды для передачи и приема датаграмм по обычному или группово¬ 
му имени, а также для передачи и приема датаграмм, адресованных одновре¬ 
менно всем станциям в сети. 

В отличие от протокола IPX протокол NETBIOS использует разные команды 
для приема обычных датаграмм и датаграмм, адресованных всем станциям в сети. 

Протокол IPX не позволяет вам передавать пакет группе станций в сети. Вы 
можете передать пакет либо какой-либо одной станции, либо всем станциям сразу. 
С помощью NETBIOS вы можете организовать передачу данных так, что пакеты 
будут приниматься только одной группой станций в сети по ее групповому имени. 

Длина сообщений, передаваемых при помощи команд данной группы, огра¬ 
ничена 512 байтами. Через каналы вы можете передавать блоки данных суще¬ 
ственно большего размера. 

NBJWSendDatagram (0x20) 

Команда предназначена для передачи блока данных размером от 1 до 512 
байт в виде датаграммы (без подтверждения приема). Датаграмма может быть 
послана на обычное или групповое имя. 

Для передачи датаграммы вам не надо создавать канал с принимающей станцией. 


Поля NCB на входе 

Содержимое 

Cmd 

NetworkNameNumber 

CallName 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x20 

Номер, присвоенный при добавлении имени 

Имя станции, которой передаются данные 

Адрес буфера, содержащего передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 
на выходе 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

" ДИАЛОГ-МИФИ• 
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0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 



0x00 

Нет ошибок 

0x01 

Неправильная длина буфера 

0x03 

Неправильный код команды 

0x13 

Неправильный номер имени 

0x19 

Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необьиное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_SendDatagram (ОхАО) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхАО. 


NB_WSendBroadcastDatagram . (0x22 ) 

Команда посьиает датаграмму, которую примут все станции, выдавшие ко¬ 
манду NB_ReceiveBroadcastDatagram (в том числе и передающая станция, если 
она тоже выдала команду NB_ReceiveBroadcastDatagram). 

Если на одной станции команда NB_ReceiveBroadcastDatagram выдана несколько 
раз, все буферы после приема данньи будут содержать одну и ту же информацию. 

Заметим, что датаграммы, посылаемые этой командой одновременно всем 
станциям, могут быть приняты только теми станциями, которые выдали команду 
NB_ReceiveBroadcastDatagram. Поэтому если станция желает принимать датаг¬ 
раммы, передаваемые в "широковещательном" режиме, она должна специально 
к этому подготовиться. В протоколе IPX (в отличие от протокола NETBIOS) 
существует одна универсальная функция, которая может принимать и обычные, 
и "широковещательные" датаграммы. 

Поля NCB на входе _ Содержим ое 

Cmd 0x22 ^ 

NetworkNameNumber Номер, присвоенный при добавлении имени 

Buffer Адрес буфера, содержащего передаваемые данные 

Size Размер буфера 
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PostRoutine 

AdapterNumber 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x01 

0x03 

0x13 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Нет ошибок 

Неправильная длина буфера 

Неправильный код команды 

Неправильный номер имени 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_SendBroadcastDatagram (0xA2) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0хА2. 


NBJWReceiveDatagram (0x21) 

Команда предназначена для приема датаграмм, переданных командой 
NB_SendDatagram. Она не может принимать датаграммы, переданные в "широ- 
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ковещательном" режиме командой NB_SendBroadcastDatagram. Однако эта 
команда может принимать датаграммы, посланные на групповое имя. 

Если перед вызовом команды в поле NetworkNameNumber блока NCB запи- 

сать значение OxFF, команда сможет принимать датаграммы от любой станции 
для любого имени. 

Если длина принятой датаграммы превышает значение, указанное в поле 
Size, принятый блок данных будет обрезан. 

Поля NCB на входе 

Содержимое 

Cmd 

0x21 

NetworkNameNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

Номер, присвоенный при добавлении имени или OxFF 
Адрес буфера, содержащего передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CallName 

Size 

CCode 

FinalCCode 

Имя станции, от которой получена датаграмма 

Размер принятого блока данных 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

Нет ошибок 

0x03 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x01 

0x03 

0x06 

Неправильная дайна буфера 

Неправильный код команды 

Размер буфера слишком мал для того, чтобы разме¬ 
стить в нем принятые данные 
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ОхОВ 

0x13 

0x17 

0x19 

0x21 

0x22 

0x23 

0x40 - Ox4F 

0x50 - OxFE 

Команда отменена 

Неправильный номер имени 

Имя удалено 

Конфликт имен (внутренняя ошибка NETBIOS) 
Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 

NB_ReceiveDatagrdm (OxAl) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0хА1. 

NBJVReceiveBroadcastDatagram (0x23) 

Команда предназначена для приема датаграмм, переданных командой 
NBJSendBroadcastDatagram. Она не может принимать датаграммы, переданные 
командой NB_SendDatagram. 

Если перед вызовом команды в поле NetworkNameNumber блока NCB запи¬ 
сать значение OxFF, команда сможет принимать датаграммы от любой станции 
для любого имени. 

Если длина принятой датаграммы превышает значение, указанное в поле 
Size, принятый блок данных будет обрезан. 

Поля NCB на входе 

Содержимое 

Cmd 

NetworkNameNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x23 

Номер, присвоенный при добавлении имени или OxFF 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 

Поля NCB на выходе 

Содержимое 

CallName 

Size 

CCode 

FinalCCode 

Имя станции, от которой получена датаграмма 

Размер принятого блока данных 

Промежуточный код завершения команды 
Окончательный код завершения команды 
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Содержимое поля CCode 
на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 

Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x01 

Неправильная длина буфера 

0x03 

Неправильный код команды 

0x06 

Размер буфера слишком мал для того, чтобы разме¬ 
стить в нем принятые данные 

0х0В 

Команда отменена 

0x13 

Неправильный номер имени 

0x17 

Имя удалено 

0x19 

Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NBJReceiveBroadcastDatagram (ОхАЗ) 


Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхАЗ. 

4.3.3. Работа с каналами 

В группе команд, предназначенных для работы с каналами, есть команды для 
создания канала, команды для удаления канала, а также команда для определе¬ 
ния состояния канала. 

Канал создается одновременно двумя станциями, одна из которых при этом нахо¬ 
дится в режиме приема запроса на создание канала, а другая передает такой запрос. 
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Вы можете создать канал между любыми двумя именами в сети. При работе с 
каналами имена используются только для создания каналов. Впоследствии, 
когда каналы уже будут созданы, для передачи данных используются номера 
каналов, а не имена или номера имен. 

Можно создать канал с самим собой, если при создании канала указать в ка¬ 
честве имени партнера свое имя. 

NBJWCall ( 0x10) 

Команда устанавливает канал между двумя именами, заданными в блоке NCB. 
Эти имена могут относиться к программам, работающим на разных станциях или 
на одной станции. В поле OurName указывается имя станции, которая уста¬ 
навливает канал, в поле CallName - имя станции, с которой устанавливается канал. 

Для успешного создания канала принимающая сторона должна выдать ко¬ 
манду NB_Listen, которая будет описана ниже. 

Можно установить канал не только с обычным, но и с групповым именем. 
Для этого придется выдать команду NB.WCall несколько раз, так как за один 
вызов создается только один канал. „ 

Команда NB_WCall делает несколько попыток создать канал и в случае 
неудачи возвращает код ошибки. . _ - ■ ■ 

При создании канала указывается время тайм-аута для операции приема и 
передачи данных. Если команды приема или передачи данных через каналы не 
будут выполнены в течение времени тайм-аута, они (команды) будут прерваны. 
При этом считается, что канал неработоспособен. 

После создания канала поле LocalSessionNumber будет содержать присвоен¬ 
ный номер канала. Сохраните его для использования в процессе приема и пере- 
дачи данных по каналу. 


Поля NCB на входе 

Содержимое 

Cmd 

CallName 

OurName 

ReceiveTimeout 

SendTimeout 

PostRoutine 

AdapterNumber 

0x10 

Имя, с которым устанавливается канал 

Имя станции, создающей канал 

Время ожидания приема, в 1/2 с 

Время ожидания передачи, в 1/2 с 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 

Поля NCB на выходе 

Содержимое 

LocalSessionNumber 

CCode 

FinalCCode 

Присвоенный номер канала 

Промежуточный код завершения команды 
Окончательный код завершения команды 
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Содержимое поля CCode 
на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x09 

Нет доступных ресурсов 

0x15 

Неправильное имя 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x05 

Истекло время ожидания 

0x09 

Нет доступных ресурсов 

0х0В 

Команда отменена 

0x11 

Переполнилась таблица каналов 

0x12 

Создание канала отвергнуто 

0x14 

Нет ответа от станции с указанным именем или в сети 


нет такого имени 

0x15 

Неправильное имя 

0x18 

Ненормальное закрытие канала 

0x19 

Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NBJCall (0x90) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x90. 
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NBJVListen (Oxll) 

Команда работает в паре с предыдущей командой и предназначена для орга¬ 
низации канала с вызываемой стороны. 

В поле CallName блока NCB необходимо указать имя, с которым устанавли¬ 
вается канал. Если в первый байт имени записать символ канал будет уста¬ 
новлен с любой вызывающей станцией. 

Программа может выдать несколько команд NB_Listen для создания одно¬ 
временно нескольких каналов. 

В случае успешного завершения команда запишет в поле LocalSessionNumber 
номер созданного канала. 

При создании канала необходимо указать время тайм-аута для операций 
приема и передачи данных через канал. Сама команда NB_WListen не исполь¬ 
зует тайм-аут. Программа, выдавшая эту команду, будет находиться в состоянии 
ожидания до тех пор, пока какая-либо станция не пожелает создать с ней ка¬ 
нал. Для исключения состояния "зависания" программы лучше использовать 
вариант NB Listen этой команды (без ожидания). 


Поля NCB на входе 

Cmd 

CallName 


OurName 

ReceiveTimeout 

SendTimeout 

PostRoutine 

AdapterNumber 


Содержимое _ 

Oxll 

Имя, с которым устанавливается канал. Если в первый 
байт имени записать символ канал будет 
установлен с любой вызывающей станцией 
Имя станции, создающей канал с принимающей 
стороны 

Время ожидания приема, в 1/2 с 
Время ожидания передачи, в 1/2 с 
Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 
Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе Содержимое 

LocalSessionNumber Присвоенный номер канала 

CallName В это поле записывается имя вызвавшей станции, если 

при установлении канала было указано имя 
CCode Промежуточный код завершения команды 

FinalCCode _Окончательный код завершения команды 


Содержимое поля CCode Значение 
на выходе 


0x00 

0x03 

0x09 


Нет ошибок 

Неправильный код команды 
Нет доступных ресурсов 
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0x15 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Неправильное имя 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 



Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x09 

Нет доступных ресурсов 

0х0В 

Команда отменена 

0x11 

Переполнилась таблица каналов 

0x15 

Неправильное имя 

0x17 

Указанное имя было удалено 

0x18 

Ненормальное закрытие канала 

0x19 

Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


N В _Listen (0x91) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x91. 


NB_WHangUp (0x12) 

Команда предназначена для закрытия канала, номер которого указан в поле 
LocalSessionNumber блока NCB. Она должна быть выполнена с обеих сторон 
канала после завершения работы. 

Если для закрываемого с помощью этой команды канала на других станциях 
выдана команда NB_WReceive, она завершается с кодом ошибки ОхОА. Выдан¬ 
ная для закрываемого канала команда NB_WSend также завершается с кодом 
ОхОА, но через 20 секунд, которые отводятся ей для завершения своей работы. 
Если команда NB_WSend не успела завершить передачу за 20 секунд, команда 
NB_WHangUp завершается с кодом 0x05. 
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Аналогично с кодом ОхОА завершает свою работу и команда NB_WReceiveAny, 
выданная для закрываемого канала. 

Другие команды, выданные для закрываемого канала, завершаются с кодом 0x18. 

Если программа пытается закрыть канал, который был уже закрыт или не 
существовал, такая ситуация не считается ошибочной и в поле кода ошибки 
проставляется нулевое значение. 

Поля NCB на входе - 

Содержимое 

Cmd 

LocalSessionNumber 

PostRoutine 

0x12 

Номер закрываемого канала 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 

Содержимое поля 
FinalCCode на выходе 

Значение 


0x00 

0x03 

0x05 

0x08 

ОхОА 

ОхОВ 

0x18 

0x19 

0x21 

0x22 


Нет ошибок 

Неправильный код команды 

Истекло время ожидания 

Неправильный номер канала 

Канал уже закрыт 

Команда отменена 

Ненормальное закрытие канала 

Конфликт имен (внутренняя ошибка NETBIOS) 

Интерфейс занят 

Выдано слишком много команд 


" ДИАЛОГ-МИФИ " 
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0x23 Неправильное значение в поле номера адаптера 

AdapterNumber 

0x40 - 0x4F Необычное состояние сети (Unusual network condition) 

0x50 - OxFE Сбой сетевого адаптера или другого сетевого аппа- 

ратного обеспечения 

NB_HangUp (0x92) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x92. 

NBJWSessionStatus (0x34) 

Команда возвращает программе состояние канала, имя которого указано в поле 
OurName блока NCB. В качестве имени можно указать символ в этом случае 
программа получит информацию о каналах, относящихся ко всем именам станций, 
имеющихся в локальной таблице имен на вызывающей команду станции. 

Информация о состоянии каналов возвращается в буфер, адрес которого 
программа должна записать в поле Buffer блока NCB. Размер буфера должен 
быть указан в поле Size блока NCB. 

Формат буфера можно описать следующей структурой: 
struct _SESSION_STATOS { 

unsigned char NameNumber; 
unsigned char SessionCount; 
unsigned char DatagramsOutstanding; 
unsigned char ReceiveAnyoutstanding; 
struct .SESSION { 

unsigned char LocalSessionNumber; 
unsigned char State; 
char LocalName[16]; 
char RemoteName[16]; 
unsigned char ReceiveCount; 
unsigned char SendCount; 

> Session[40]; 

>t 

Приведем список полей буфера: 


Название поля 

NameNumber 

SessionCount 

DatagramsOutstanding 

ReceiveAnyoutstanding 

Session 


Назначение поля 
Номер имени канала 
Количество каналов 

Количество выданных команд на прием датаграмм 
Количество выданных команд на прием командой 
NB.ReceiveAny 

Массив структур, описывающих каждый канал в 

отдельности 

Номер канала 


LocalSessionNumber 
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State 

Состояние канала: 

1 - ожидание завершения команды NB_Listen; 

3 - канал установлен; 

4 - ожидание завершения команды NB_HangUp; 

5 - команда NB_HangUp завершила свое вы¬ 

LocalName 

RemoteName 

ReceiveCount 

SendCount 

полнение; 

6 - канал закрыт с ошибкой. 

Имя локальной станции 

Имя удаленной станции 

Количество ожидающих завершение команд NB_Receive 
Количество ожидающих завершения команд NB Send 


Поля NCB на входе 

Содержимое 

Cmd 

Buffer 

0x34 

Дальний адрес буфера для приема информации 
о состоянии каналов 

Size 

OurNames 

Размер буфера 

Имя канала, для которого необходимо получить 
информацию о состоянии. В качестве имени можно 

PostRoutine 

указывать 

Дальний указатель на POST -программу или нулевое 

AdapterNumber 

значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

Size 

CCode 

FinalCCode 

Размер заполненной части буфера 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x15 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Неправильное имя 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 

0x40 - 0x4F 

0x50 - OxFE 

AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


" ДИАЛОГ-МИФИ " 
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Содержимое поля 

FinalCCode на выходе 

(МЮ 

0x01 

0x03 

0x06 

0x19 

0x21 

0x22 

0x23 

0x40 - 0x4F 
0x50 - OxFE 


Значение 


Нет ошибок 

Неправильная длина буфера 

Неправильный код команды 

Слишком мал размер выделенного буфера 

Конфликт имен (внутренняя ошибка NETBIOS) 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 

AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа- 
ратного обеспечения 


NB_SessionStatus (0хВ4) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0хВ4. 


4.3.4. Прием и передача данных через каналы 


NBJWSend (0x14) 

С помощью этой команды программа может передать блок данных размером 
от 1 до 65535 байт по созданному ранее каналу. Перед вызовом команды прог¬ 
рамма должна записать номер канала, по которому будет выполняться передача, 
в поле LocalSessionNumber блока NCB. Адрес передаваемого блока данных и 
его длина должны быть записаны в поля Buffer и Size. 

Для приема данных, передаваемых командой NB_WSend, необходимо 
использовать команду NB_WReceive (или NB_Receive). 

Механизм передачи данных с использованием каналов гарантирует не только 
доставку блоков данных, но и правильную последовательность, в которой эти 
блоки будут приняты. 

Если истекло время тайм-аута, заданного при создании канала, команда за¬ 
вершается с ошибкой. 


Поля NCB на входе 
Cmd 

LocalSessionNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 


Содержимое 

0x14 

Номер используемого канала 

Указатель на буфер, содержащий передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 
Номер адаптера; 0 - первый адаптер, 1 - второй 
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Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode Значение 
на выходе 


0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 

0x40 - 0x4F 

0x50 - OxFE 

AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x03 

0x05 

0x08 

0х0А 

0х0В 

0x18 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Истекло время ожидания 

Неправильный номер канала 

Канал закрыт 

Команда отменена 

Ненормальное закрытие канала 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 

0x40 - 0x4F 

0x50 - OxFE 

AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_Send (0x94) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x94. 

NBJWSendNoAck (0x71) 

По своему назначению команда полностью аналогична предыдущей, однако в 
отличие от нее не выполняет проверку доставки блока данных принимающей 
стороне. За счет этого она работает немного быстрее. 


•ДИАЛОГ-МИФИ" 
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Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

PostRoutine 

0x71 " --- 

Номер используемого канала 

Указатель на буфер, содержащий передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

AdapterNumber 

Номер адаптера; 0 - первый адаптер. 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 

Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x03 

0x05 

0x08 

0х0А 

0х0В 

0x18 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Истекло время ожидания 

Неправильный номер канала 

Канал закрыт 

Команда отменена 

Ненормальное закрытие канала 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 
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NB_SendNoAck (OxFl) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение OxFl. 

NBJNChainSend (0x17) 

Команда работает аналогично команде NB_WSend, однако с ее помощью можно 
передать сразу два блока данных. Данные передаются как один блок. Общий раз¬ 
мер передаваемых с помощью этой команды данных может достигать 131070 байт. 

Первый буфер задается, как и для команды NB_WSend, через поля Buffer и 
Size. Размер второго буфера должен быть записан в первые два байта поля 
CallName блока ЕСВ, а его адрес занимает следующие четыре байта этого поля. 


Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

CallName 

PostRoutine 

AdapterNumber 

0x17 

Номер используемого канала 

Указатель на первый буфер, содержащий передава¬ 
емые данные 

Размер первого буфера 

Первые два байта содержат размер второго буфера, 
следующие четыре байта - дальний адрес второго 
буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 
на выходе 

Значение 


0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


- ДИАЛОГ-МИФИ ■ 
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Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x05 

Истекло время ожидания 

0x08 

Неправильный номер канала 

0х0А 

Канал закрыт 

0х0В 

Команда отменена 

0x18 

Ненормальное закрытие канала 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NBjChainSend (0x97) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x97. 


NBJVChainSendNoAck (0x72) 


Команда аналогична команде NB_WCainSend, однако в отличие от нее не 

этого она работает немного быстрее. 

Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

CallName 

PostRoutine 

AdapterNumber 

0x72 

Номер используемого канала 

Указатель на первый буфер, содержащий передаваемые 
данные 

Размер первого буфера 

Первые два байта содержат размер второго буфера, 
следующие четыре байта - дальний адрес второго буфера 
Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 
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Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят ' 

Вьщано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x^0 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x03 

0x05 

0x08 

0х0А 

0х0В 

0x18 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Истекло время ожидания 

Неправильный номер канала 

Канал закрыт 

Команда отменена 

Ненормальное закрытие канала 

Интерфейс занят 

Вьщано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NBjChainSendNoAck (0xF2) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0xF2. 

NBJVReceive (0x15) 

Команда принимает данные, посланные командами NB_WSend или 
NB.WChainSend. 

Если размер буфера недостаточен для записи принятых данных, команда воз¬ 
вращает код ошибки 0x06; в этом случае вы можете вызвать команду еще раз 
для того, чтобы прочесть данные, не поместившиеся в буфере при предыдущем 
вызове команды. 


■ДИАЛОГ-МИФИ' 
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Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

0x15 

Номер используемого канала 

Указатель на буфер, используемый для записи при¬ 
нятых данных 

Size 

PostRoutine 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

AdapterNumber 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

Size 

CCode 

FinalCCode 

Количество принятых и записанных в буфер байт данных 
Промежуточный код завершения командъ; 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

0x23 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

0x50 - OxFE. 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

0x03 

0x05 

0x06 

Нет ошибок 

Неправильный код команды 

Истекло время ожидания 

Размер буфера недостаточен для записи принятых 
данных 

0x08 

0х0А 

0х0В 

0x18 

0x21 

0x22 

Неправильный номер канала 

Канал закрыт 

Команда отменена 

Ненормальное закрытие канала 

Интерфейс занят 

Выдано слишком много команд 
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Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_Receive (0x95) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x95. 

NB_WReceiveAny (0x16) 

Команда принимает данные от всех партнеров. Для этой команды вместо Но¬ 
мера канала необходимо указать номер имени, полученный вашей программой 
при добавлении имени. Если в поле NetworkNameNumber проставить значение 
OxFF, эта команда будет принимать данные от любых партнеров для любых 
каналов, созданных на вашей станции. 


Если размер буфера недостаточен для записи принятых данных, команда возвраща¬ 
ет код ошибки 0x06; в этом случае вы можете вызвать команду еще раз для того, что¬ 
бы прочесть данные, не поместившиеся в буфере при предьщущем вызове команды. 


Поля NCB на входе 

Содержимое 

Cmd 

NetworkNameNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x16 

Номер имени или OxFF 

Указатель на буфер, используемый для записи при¬ 
нятых данных 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

Size 

NetworkNameNumber 

CCode 

FinalCCode 

Количество принятых и записанных в буфер байт данных 
Номер имени станции, от которой пришли данные 
Промежуточный код завершения команды 
Окончательный код завершения команды 


Содержимое поля CCode 

Значение 

0x00 

0x03 

0x21 

0x22 

Нет ошибок 

Неправильный код команды 

Интерфейс занят 

Выдано слишком много команд 


0x23 

0x40 - 0x4F 
0x50 - OxFE 


■ДИАЛОГ- Л 
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0x23 

0x40 - 0x4F 

0x50 - OxFE 

Неправильное значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 



Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x06 

Размер буфера недостаточен для записи принятых 
данных 

0x08 

Неправильный номер канала 

ОхОА 

Канал закрыт 

0х0В 

Команда отменена 

0x13 

Неправильный номер имени 

0x17 

Указанное имя было удалено 

-0x18 

Ненормальное закрытие канала 

0x19 

Конфликт имен (внутренняя ошибка NETBIOS) 

0x21 

Интерфейс занят 

0x22 

Выдано слишком много команд 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_ReceiveAny (0x96) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x96. 


4.3.5. Другие команды 

В этом разделе мы опишем команды NETBIOS, позволяющие сбросить драй¬ 
вер NETBIOS в исходное состояние, отменить выданную ранее команду. 

NBJWResetA dap ter (0x32) 

Команда сбрасывает NETBIOS в исходное состояние, удаляет все имеющиеся 
каналы и имена (кроме постоянного имени, которое нельзя удалить, не вытащив 
сетевой адаптер из компьютера). С помощью этой команды можно также изменить 
максимальное количество доступных программе канатов и используемых одно¬ 
временно блоков NCB. По умолчанию доступны шесть каналов и 12 блоков NCB. 
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Поля NCB на входе 

Содержимое 

Cmd 

0x32 

LocalSessionNumber 

Максимальное количество каналов или 0 для 

NetworkNameNumber 

использования значения по умолчанию 

Максимальное количество блоков NCB или 0 для 

AdapterNumber 

использования значения по умолчанию 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

FinalCCode 

Окончательный код завершения команды 


Содержимое поля 
CCode на выходе 

Не используется 


Содержимое поля 
FinalCCode на выходе 

Значение 

0x00 

Нет ошибок 

0x03 

0x23 

0x40 - 0x4F 

0x50 - OxFE 

Неправильный код команды 

Неправильное Значение в поле номера адаптера 
AdapterNumber 

Необычное состояние сети (Unusual network condition) 
Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


NB_WCancel (0x35) 

Команда используется для отмены других запущенных команд. Адрес NCB 
для отменяемой команды должен быть записан в поле Buffer. 

С помощью этой команды нельзя отменить следующие команды: 
NB_AddName, NB_AddGroupName, NB_DeleteName, NBjSehdDatagramm, 
NB_SendBroadcastDatagramm, NB_ResetAdapter, NB_SessionStatus, NB_CaBeel, 
NBJJnlink. 


Поля NCB на входе 

Содержимое 

Cmd 

Buffer 

AdapterNumber 

рх35 

Указатель на блок NCB, для которого отменяется 
команда 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

FinalCCode 

Окончательный код завершения команды 


“ДИАЛОГ -A 





















122 Локальные сети персональных компьютеров 



Содержимое поля 
CCode на выходе 

Не используется 


Содержимое поля 
FinalCCode на выходе 

Значение 


0x00 

Нет ошибок 

0x03 

Неправильный код команды 

0x23 

Неправильное значение в поле номера адаптера 
AdapterNumber 

0x24 

Команда уже начала выполняться, когда пришел 
запрос на ее отмену 

0x26 

Данную команду нельзя отменить 

0x40 - 0x4F 

Необычное состояние сети (Unusual network condition) 

0x50 - OxFE 

Сбой сетевого адаптера или другого сетевого аппа¬ 
ратного обеспечения 


4.4. Коды ошибок 

Приведем список кодов ошибок, возвращаемых NETBIOS: 


Код ошибки Значение ______ 

00 Команда выполнена без ошибок 

01 Неправильная длина буфера. 

Возможно, что при выполнении операции передачи датаграммы 
указан размер буфера более 512 байт 
03 Неправильная команда 

05 Истекло заданное время ожидания. 

Истекло время ожидания для команды NB_Call. Другая возможная 
причина - истекло время ожидания, заданное при создании канала 
для команд приема или передачи данных по каналу 
06 Данные приняты не полностью. 

Указанный размер буфера недостаточен для размещения принятьи 
данных 

07 Данные, переданные в режиме без подтверждения, не были приняты 

08 Неправильный номер канала. 

Канал с указанным номером не существует 
09 Нет доступных ресурсов 

0А Канал закрыт 

0В Команда отменена 

0D Такое имя уже есть в локальной таблице имен 

0Е Переполнение локальной таблицы имен. 

Задано более 16 имен 

0F Указанное имя используется активным каналом 
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11 Переполнение локальной таблицы каналов 

12 Создание канала отвергнуто. 

Это означает, что на удаленном компьютере не выполняется команда 
NB_Listen, предназначенная для создания канала 

13 Неправильный номер адаптера 

14 NETBIOS не может найти вызываемое имя 

15 Имя не найдено или задано неправильно 

16 Имя уже используется удаленной станцией 

17 Имя удалено 

18 Ненормальное завершение работы канала. 

Либо удаленный компьютер бьи выключен, либо возникли не¬ 
исправности в его сетевом оборудовании, либо были прерваны или 
отменены выполнявшиеся там команды передачи данных по каналу 

19 Конфликт имени. 

Драйвер NETBIOS обнаружил присутствие в сети двух одинаковых 
имен, что недопустимо 

ІА Принят нестандартный пакет, не соответствующий протоколу 

NETBIOS 

21 Интерфейс занят. 

Эта ошибка появляется при попытке вызвать команду NETBIOS из 
POST -программы или обработчика прерываний 

22 Слишком много выдано команд 

23 Неправильный номер сетевого адаптера. 

Для номера адаптера можно использовать значения 00h (первый 
адаптер) или Olh (второй адаптер) 

24 Команда уже начала выполняться, когда пришел запрос на ее отмену 

26 ■ Команда не может быть отменена 

30 Имя используется другим окружением 

34 Среда не определена, необходимо выдать команду NB_Reset 

35 Ресурс занят, необходимо отложить запрос 

36 Превышено максимальное число работающих приложений 

38 Запрошенный ресурс недоступен 

39 Неправильный адрес блока NCB 

ЗА Команда NB_Reset не может выдаваться из POST -программы 

ЗС NETBIOS не смог заблокировать память программы пользователя 

3F Ошибка при открытии драйвера сетевого адаптера 

4Е - 4F Ошибка в состоянии сети 

F6 - FA Ошибка адаптера 

FB Драйвер NETBIOS не загружен 

FC Ошибка при открытии сетевого адаптера 

FD Неожиданное закрытие сетевого адаптера 

FE NETBIOS не активен 


•ДИАЛОГ-МИФИ- 
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4.5. Система "клиент-сервер" на базе датаграмм 

Приведем пример простейшей системы "клиент-сервер", в которую входят 
две программы, обменивающиеся датаграммами (листинг 18). 

Аналогичная система, сделанная на базе протокола IPX, требовала использо¬ 
вания процедуры определения сетевых адресов сервера и клиента. Так как сер¬ 
вер может быть запущен на любой станции в сети, программа-клиент сразу 
после своего запуска не может знать сетевой адрес сервера. Если вы помните, 
для определения адреса программы-сервера программа-клиент посылала пакет в 
"широковещательном" режиме сразу всем станциям в сети. Сервер, приняв этот 
пакет, отвечал клиенту, и таким образом программы узнавали адрес друг друга. 
Единственное, что должно быть известно программе-клиенту, - это номер 
сокета, на котором программа-сервер ожидает прихода пакетов. 

При использовании протокола NETBIOS ситуация сильно упрощается. Впол¬ 
не достаточно, если программа-клиент будет знать имя, которое добавляется 
сервером и используется для приема пакетов от клиентов. 

Программа-сервер начинает свою работу с создания объекта класса 
NETBIOS_DATAGRAM_SERVER. Конструктор в качестве параметра получает 
имя, добавляемое сервером и используемое для приема пакетов. В нашем слу¬ 
чае это имя "NETBIOS Server". 

В процессе своей работы конструктор класса NETBIOS_DATAGRAM_SERVER 
проверяет наличие интерфейса NETBIOS, добавляет имя, полученное им в 
качестве параметра, и сохраняет полученный номер имени для дальнейшего 
использования. После завершения работы программы деструктор класса 
NETBIOS_DATAGRAM_SERVER удалит добавленное имя. 

После проверки возможных ошибок программа-сервер вызывает функцию 
Receive^), которая ожидает прихода пакета от программы-клиента. Когда пакет 
будет получен, сервер выводит его содержимое как текстовую строку в стандар¬ 
тный поток вывода и завершает свою работу. 

И -----—______ 

II Листинг 18. Сервер NETBIOS,' вариант с 
!/ использованием датаграмм 

V/ . ѵ 

// Файл nbserver.cpp 
И 

II (С) A. Frolov, 1993 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <etring.h> 

♦include "netbios.hpp" 
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// Класс серверов NETBIOS 
class NETBIOS_DATAGRAM_SERVER { 
unsigned errno; 

void Interrupt ( *int5C)( . ..); 
public: 

// Здесь хранится имя сервера и номер этого имени 
char OurName [16]; 
unsigned NetworkNameNumber; 

// Конструктор, проверяет наличие NETBIOS и добавляет имя 
NETBIOS_DATAGRAM_SERVER(char ‘Name) { 

// Блок NCB, который будет использован при добавлении имени 
// NCB AddNameNCB ; 

// Проверяем длину имени 

if(strlen(Name) > 15) { 
errno - Oxff; 

У 

strcpy(OurName, Name); 

11 Проверяем наличие интерфейса NETBIOS 
int5C = getvect(0x5c); 

if(FP_SEG(int5C) “ 0x0000 || FP_SEG(int5C) OxFOOO) { 
errno~0xff; 
exit(-l); 

У 

// Добавляем имя 

AddNameNCB.WAddName(OurName); 

// Запоминаем полученный номер имени 

NetworkNameNumber = AddNameNCB.GetNetworkNameNumber()) 
errno = AddNameNCB.Error(); 

> 

// Деструктор, удаляет имя. 

"NET^IOS_DATAGRAH_SERVER() { 

NCB AddNameNCB; 

AddNameNCB.WDeleteName(OurName); 
errno = AddNameNCB.Error(); 

> 

// Функция для проверки кода ошибки 
int Error(void) {return errno;} 

// Функция для приема датаграммы 

void Receive(char ‘ReceiveBuffer, unsigned BufferSize) { 

NCB RecelveNCB; 


■ ДИАЛОГ-МИФИ " 
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II Записываем в NCB адрес и длину буфера 

ReceiveNCB.SetBuffer(ReceiveBuffer , BufferSize) ; 

// Выполняем прием датаграммы с ожиданием 

ReceiveNCB . WReceiveDatagram ( NetworkNameNumber ); 

> 

}; 

void main(void) { 

// Наш сервер с именем "NETBIOS Server” 

NETBIOS_DATAGRAM_SERVER Server("NETBIOS Server"); 
char ReceiveBuffer[512]; 

// Проверяем, были ли ошибки на этапе инициализации сервера, 
if(Server.Error ()) { 

printf ("Ошибка %02.2X\n", Server.Error()); 
return; 

} 

printf(" Инициализация завершена .\n"); 
printf( "Ожидаем сообщение от клиента. \n"); 

// Принимаем сообщение от клиента 

Server . Receive ( ReceiveBuffer , 512); 
printf ("Принято: >%s<\n"(ReceiveBuffer); 

> 

Программа-сервер работает в паре с программой-клиентом (листинг 19). 
После запуска программа-клиент создает объект класса 
NETBIOS_DATAGRAM_CLIENT. Конструктор и деструктор этого класса вы¬ 
полняют действия, аналогичные конструктору и деструктору класса 
NETBIOSJDATAGRAMJSERVER. 

После инициализации и проверки ошибок программа-клиент посылает сооб¬ 
щение "Привет от клиента NETBIOS!" серверу с именем "NETBIOS Server" при 
помощи функции SendO- Затем программа-клиент завершает свою работу. 

/ /-- 

// Листинг 19. Клиент NETBIOS, вариант с 
// Использованием датаграмм 

// 

II Файл nbclient.cpp 

И 

И (С) A. Frolov, 1993 

// ----------- 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 
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# include "netbios.hpp" 

// Класс клиентов NETBIOS 
class NETBIOS_DATAGRAM_CLIENT { 
unsigned errno; 
public: 

// Здесь хранится'имя клиента и номер этого имени 
char OurName [16]; 
unsigned NetworkNameNumber; 
union REGS regs; 

// Конструктор, проверяет наличие NETBIOS и добавляет имя 
NETBIOS_DATAGRAM_CLIENT ( char *Name).{ 

// Блок NCB, который будет использован при добавлении имени 
NCB AddNameNCB; 

// Проверяем длину имени имя 

if(strlen(Name) > 15) { 
errno = Oxff; 

> . 

s trcpy(OurNsune, Name); 

// Проверяем наличие интерфейса NETBIOS 
int5C = getvect(0x5c); 
errno = 0; ' 

if (FP_SEG(int5C) == 0x0000 || FP_SEG( int5C) «= 0xF0.00) .{ 
errnp=0xff; 

. exit(-l); 

} ; 

// Добавляем имя 

AddNameNCB.WAddName(OurName); 

// Запоминаем полученный номер имени 

NetworkNameNumber = AddNameNCB'GetNetworkNameNumber( ); 
errno = AddNameNCB.Error(); 

> 

// Деструктор, удаляет имя. 

”NETBIOS_DATAGRAM_CLIENT() { 

NCB AddNameNCB; 

AddNameNCB.WDeleteName(OurName); 
errno = AddNameNCB.Error(); 

// Функция для проверки кода ошибки 
int Error(void) {return errno;) 


■ДИАЛОГ-МИФИ- 
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1 1 Функция для приема датаграммы 

void Receive(char ‘ReceiveBuffer, unsigned BufferSize) { 

NCB ReceiveNCB; 

// Записываем в NCB адрес и длину буфера 

ReceiveNCB.SetBuffer (ReceiveBuffer , BufferSize); 

// Выполняем прием датаграммы с ожиданием 

ReceiveNCB .WReceiveDatagram(NetworkNameNumber ); 

> 

// Функция для передачи датаграммы 

void Send(char *ReceiveBuf fer , unsigned BufferSize, 
char *CallName) { 

NCB SendNCB; 

// Устанавливаем адрес и длину буфера 

SendNCB. SetBuffer(ReceiVeBuffer, BufferSize); 

// Устанавливаем имя партнера, которому будет передана 
II. наша датаграмма 

SendNCB . SetCa 1 lName (Са 1 lName ); 

1 1 Передаем датаграмму с ожиданием 

SendNCB . WSendDatagram(NetworkNameNumber) ; 

У 

У; 

void main(void) { 

// Наш клиент с именем "NETBIOS Client" ' 

NETBIOS_DATAGRAM_CLIENT Client("NETBIOS Client"); 

// Проверяем, были ли ошибки на этапе инициализации клиента, 
if(Client.Error ()) { 

printf ( "Ошибка %02.2xSn", Client.Error(^)■); 
return; 

} 

printf( "Инициализация завершена .\n"); 

// Передаем сообщение серверу с именем "NETBIOS Server" 

Client.Send( "Привет от клиента NETBIOS!" ,512, "NETBIOS 
Server") ; 

> 

В include -файле netbios.hpp (листинг 20) приведены определения констант и 
классов для работы с протоколом NETBIOS через прерывание INT 5СЬ. 

В классе NCB, кроме структуры данных _NCB, определены конструктор 
NCB0 и несколько других функций дая работы с этим классом. 

Конструктор расписывает структуру neb нулями и сбрасывает код ошибки в 
переменной ermo. 

Функция NetBiosO вызывает прерывание NETBIOS. 
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Функции WAddNameO и WDeleteNameO определены в файле nbfunc.cpp 
(листинг 21). Они предназначены для добавления и удаления имени. 

Назначение остальных функций вы можете узнать, прочитав комментарии к 
программе в листинге 20. 

// -- —„—— _____ _ _ 

// Листинг 20. Классы для работы с NETBIOS 

// 

// Файл netbios.hpp 
// ' 

// <С) A. Frolov, 1993 

. // —— -- - , 

// Команды NETBIOS 

// Команды для работы с именами 

♦define NB_WAddName 0x30 

♦define NB_AddName OxbO 

♦define NB_WAddGroupName 0x36 

♦define NB_AddGroupName 0xb6 

♦define NB_WDeleteName 0x31 

♦define NB_DeleteName Oxbl 

// Команды для передачи датаграмм 

♦define NB_WSendDatagram 0x20 

♦define NB_SendDatagram OxaO 

♦define NB_WSendBroadcastDatagram 0x22 

♦define NB_SendBroadcastDatagran 0xa2 

// Команды для приема датаграмм 

♦define NB_WReceiveDatagram 0x21 

♦define NB_ReceiveDatagram Oxal 

♦define NB_WReceiveBroadcastDatagram 0x23 

♦define NB_ReceiveBroadca'stDatagram 0xa3 

// Команды для работы с каналами 

♦define NB_WCall 0x10 

♦define NB_Call 0x90 

♦define NB_WListen 0x11 

♦define NB_Listen 0x91 ■ 

♦define NB_WHangOp 0x12 
♦define NB_HangUp 0x92 

// Команды для передачи данных По каналу 

♦define NB_WSend 0хІ4- 

♦define NB_Send 0x94 

♦define NB_WSendNoAck 0x71 

♦define NB_SendNoAck Oxfl 

♦define NB_WChainSend 0x17 

♦defind NB_ChainSend 0x97 . 

♦define NB_WChainSendNoAck 0x72 
♦define NB_ChainSendNoAck 0xf2 

•ДИАЛОГ-МИФИ' 
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II Команды для приема данных по каналу 

♦define NB_WReceive 0x15 

♦define NB_Receive 0x95 

♦define NB_WReceiveAny 0x16 

♦define NB_ReceiveAny 0x96 

// Прочие команды 

♦define NB_WResetAdapter 0x32 

♦define NB_WCancel 0x35 

♦define NB_WSessionStatus 0x34 

♦define NB_SessionStatus 0xb4 

// Класс NCB для работы с командами NETBIOS 

class NCB { 

// Стандартный блок NCB в формате NETBIOS 
struct _NCB { 

unsigned char Cmdj 

unsigned char CCode; 

unsigned char LocalSessionNumber; 

unsigned char NetworkNaraeNumber; 

void far ‘Buffer; 

unsigned Size; 

char CallName[16]; 

char OurName[16]; 

unsigned cftar ReceiveTlmeout; 

unsigned char SendTimeout; 

void interrupt (‘PostRoutine)(void) 

unsigned char AdapterNumber; 

unsigned char FinalCCode; 

unsigned char Reserved!14]; 

> neb; 

struct SREGS sregs; 
union REGS regs; 
unsigned errno; 

II Функция для вызова NETBIOS 
void NetBios(void) { 

sregs.es - FP_SEG(tneb); 
regs.x.bx = FP_OFF(Sncb); 
int86x(0x5c, Sregs, Sregs, Ssregs); 


public; 

// Конструктор, расписывает neb нулями 
NCB() { 

memset(sncb, 0, sizeof(neb)); 
errno =0; 

> 
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// Функция возвращает код ошибки 

int Error(void) {return errno;} 

// Функция дпя добавления имени 
void WAddName ( char * name); 

// Функция для удаления имени 

void WDeleteName(char 'name); 

// Функция для определения номера имени 
unsigned GetNetworkNameNumber ( void ) 

{ return ( neb.NetworkNameNumber ); > 

// Функция для установки адреса и размера буфера 

void SetBuffer(char far *Buf, unsigned BufSize) { 
neb.Buffer - Buf; 
neb.Size - BufSize; 

> 

// Установка в neb имени вызываемого партнера 
void SetCallName(char ‘name); 

// Прием датаграмм с ожиданием 

void WReceiveDatagram(int NetwrkNameNumber) { 

// Заполняем поле номера своего имени 

ncb.NetworkNameNumber = NetwrkNameNumber; 

// Вызываем NETBIOS 

> ncb.Cmd = NB_WReceiveDatagram; 

NetBios(); 

> 

// Передача датаграмм с ожиданием 

void WSendDatagram(int NetwrkNameNumber) { 

// Заполняем поле номера своего имени 

ncb.NetworkNameNumber = NetwrkNameNumber; 
ncb.Cmd = NB_WSendDatagram; 

// Вызываем NETBIOS 
NetBios(); 


" ДИАЛОГ-МИФИ ■ 
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В файле nbfunc.cpp приведены определения некоторых функций из класса 
NCB (листинг 21): 

И ШШШЩШШШ -.........---—-——- 

// Листинг 21. Функции для NETBIOS 

// 

// Файл nbfunc.cpp 

И 

И (С) A. Frolov, 1993 

U ----- 

(Include <etdlo.h> 

(include <stdlib.b> 

(include <dos.h> 

(include <conio.h> 

(include <mem.h> 

(include <string.h> 

(include "netbios.hpp" 

II Добавляем имя 

void NCB:IWAddName(char *name) { 
char buf[16]; 

11 Проверяем длину имени 

if(strlen(name) > 15) { 
errno - Oxff; 

> 

strcpyfbuf, name); 

// При необходимости дополняем имя пробелами 

while (atrlen(buf) < 15) 8trcat(buf, " "); 

// Вызываем NETBIOS 

ncb.Cmd = NB_WAddName; 
strcpy(ncb.OurName, buf); 

NetBios(); 

errno - ncb.FinalCCode; 

> 

// Удаление имени 

void NCB::WDeleteName(char ‘name) { 
char buf[16]; 

// Проверяем длину имени 

if(strlen(name) > 15) { 
errno = Oxff; 

> 

strcpyfbuf, name); 

// При необходимости дополняем имя 


пробелами 
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while (strlen(buf) < 15) strcat(buf, " “.); 
strcpy(neb.OurName, buf); 

// Вызываем NETBIOS 

ncb.Cmd = NB_WDeleteName; 

NetBIOS(); 

errno = neb.FinalCCode; 

// Установка имени вызываемого партнера 
void NCB::SetCallName(char *name) { 
char buf[16]; 
if(strlen(name) > 15) { 
errno = Oxff; 

> 

strepy(buf, name); 

while (strlen(buf) < 15) strcat(buf, " "); 
strepy(neb.CallName, buf); 


4.6. Система "клиент-сервер" на базе каналов 

Приведем пример системы "клиент-сервер”, реализованной с использова¬ 
нием каналов протокола NETBIOS (листинг 22). 

После запуска ' программа-сервер создает объект класса 
NETBIOS_SESSION_SERVER. Конструктор этого объекта проверяет присут¬ 
ствие интерфейса NETBIOS, добавляет имя, переданное ему в качестве пара¬ 
метра, затем создает канал при помощи функции WListenO- 

Деструктор класса NETBIOS_SESSION_SERVER перед удалением имени удаля¬ 
ет канал, так как имя нельзя удалить, если оно используется каким-либо каналом. 

После того, как отработал конструктор, программа-сервер проверяет ошибки 
и вызывает функцию ReceiveO, которая ожидает приема данных по созданному 
каналу. После приема сервер отображает принятые данные как текстовую стро¬ 
ку и завершает свою работу. 


// Листинг 22. Сервер NETBIOS, вариант с 
// использованием каналов 

// 

// Файл nbserver.cpp 

// 

И (С) A. Frolov, 1993 
/) 

♦include <stdio.h> 

♦include <stdlib.h> 

♦include <dos.h> 


1 ДИАЛОГ-МИФИ ■ 
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tinclude <conio.h> 

# include <mem.h> 

(include <string.h> 

(include "netbios.hpp" 

// Класс серверов NETBIOS 
class NETBIOS_SESSION_SERVER { 


unsigned errno; 

void interrupt ( *int5C)(...)) 
public: 

// Здесь хранится имя сервера и номер этого имени 
char OurName [16]; 
unsigned NetworkNameNumber; 

// Блок NCB, который будет использован при добавлении имени 
NCB AddNameNCB; 

// Конструктор, проверяет наличие NETBIOS и добавляет имя 
NETBIOS_SESSION_SERVER(char *Name) { 

// Проверяем длину имени имя 

if(strlen(Name) > 15) { 
errno = Oxff; 

} 

strcpy(OurName, Name); 

// Проверяем наличие интерфейса NETBIOS 
int5C - getvect(0x5c); 


if(FP_SEG(int5C) — 0x0000 || FP_SEG(int5C) == OxFOOO) { 
errno=0xff; 
exit(-l); 

> 

II Добавляем имя 

AddNameNCB.WAddName(OurName); 

II Запоминаем полученный номер имени 

NetworkNameNumber - AddNameNCB.GetNetworkNameNumber(); 
errno = AddNameNCB.Error(); 
if(errno) return; 

// Устанавливаем в поле CallName, это означает, 

// что сервер будет обрабатывать запросы на создание 
// канала от любого имени 

AddNameNCB . SetCallName (“*"); 

// Устанавливаем время тайм-аута для команд 
// приема и передачи данных по каналу 
AddNameNCB.SetRtoSto( 20,20); 
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// Создаем канал с принимающей стороны 
AddNameNCB . WLis ten (); 

> , 

// Деструктор, удаляет канал и имя. 

"NETBIOS_SESSION_SERVER( ) { 

// Удаление канала 

AddNameNCB.WHangUp( ); 

// Удаление имени 

AddNameNCB.WDeleteName(OurName) ; 
errno « AddNameNCB.Error (}; 

} . ' 

// Функция для проверки кода ошибки 
int Error(void) {return errno;> 

// Функция для приема данных по каналу 

void Receive(char *ReceiveBuffer , unsigned BufferSize) { 

// Записываем в NCB адрес и длину буфера 

AddNameNCB.SetBuffer(ReceiveBuffer , BufferSize); 

// Выполняем прием датаграммы с ожиданием 
AddNameNCB.WReceive( ); 

> 

>; 

void main(void) { 

// Наш сервер с именем "NETBIOS Server" 

NETBIOS_SESSION_SERVER Server("NETBIOS Server"); . 

Char ReceiveBuffer[512]; 

// Проверяем, были ли ошибки на этапе инициализации сервера, 
if(Server.Error( )) { 

printf( "Ошибка %02.2X\n", Server.Error()); 

> ’ ; 

printf( "Инициализация завершена. \n"); 

printf ("Ожидаем сообщение от клиента. \n"V; 

// Принимаем сообщение от клиента по каналу, который был создан 
// конструктором класса NETBIOS_SESSldN_SERVER 
Server . Receive ( ReceiveBuf fer, 512); 
printf( "Принято: >%s<\n",ReceiveBuffer); 

} " ■ ■ '• ■■ -■ " 

В файле nbclient.cpp находится программа-клиент (листинг 23), работающая в 
паре с только что приведенной программой-сервером. 

Программа-клиент создает объект NETBIOS_SESSION_CLIENT, конструктор 
которого выполняет действия, аналогичные конструктору класса 
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NETBIOS_SESSION_SERVER. Есть одно отличие: для создания канала в кон¬ 
структоре класса NETBIOS_SESSION_CLEENT используется функция WCallO, 
а не WListenO- Конструктор создает канал с программой-сервером, указывая 
имя "NETBIOS Server", которое используется сервером для работы с клиентом. 

После проверки ошибок программа-клиент с помощью функции SendO пере¬ 
дает по созданному каналу программе-серверу сообщение "Привет от клиента 
NETBIOS!" и завершает свою работу. 


// —— -- - -—--- 

// Листинг 23. Клиент NETBIOS, вариант с 
// использованием каналов 

// 

// Файл nbclient.cpp 

// 

// (С) A. Frolov, 1993 

tInclude <stdio.h> 

((include <stdlib.h> 

♦include <dos.h> 

♦include <conio.h> 

♦include <mem.h> 

♦include <string.h> 

♦include “netbios.hpp" 

// Класс клиентов NETBIOS 
class NETBIOS_SESSION_CLIENT { 
unsigned errno; 

void interrupt ( *int5C)(...); 

// Блок NCB, который будет использовав- при добавлении имени 
NCB AddNameNCB; 

public : 

// Здесь хранится имя клиента и номер этого имени 
char OurName[16] ; 
unsigned NetworkNameNumber; 

II Конструктор, проверяет наличие NETBIOS и добавляет имя 
NETBIOS_SESSION_CLIENT(char *Name) { 

// Проверяем длину имени имя 

if(strlen(Name) > 15) { 
errno = Oxff; 

> 

s trcpy(OurName, Name); 

II Проверяем наличие интерфейса NETBIOS 
int5C = getvect(0x5c); 
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if(FP_SEG(int5C) — 0x0000 || FP_SEG(int5C) -« OxFOOO) { 
errno=0xff; 
exit(-l); 

} 

// Добавляем имя 

AddNameNCB. WAddName (Our Name) ; 

// Запоминаем полученный номер имени 

NetworkNameNumber = AddNameNCB.GetNetworkNameNumber(); 

II Если при добавлении имени были ошибки, 

// завершаем работу программы 

errno = AddNameNCB.Error (); 
if(errno) return; 

// Устанавливаем имя сервера, с которым будем создавать канал 
AddNameNCB.SetCallNamef"NETBIOS Server"); 

// Устанавливаем время тайм-аута 
// для передачи и приема данных по каналу 
AddNameNCB.SetRtoStolj 20,20); 

// Устанавливаем канал с передающей стороны 
AddNameNCB.WCall (); 

> 

II Деструктор, удаляет канал и имя. 

”NETBIOS_SESSION_CLIENT( ) { 

// Удаление канала 

AddNameNCB . WHangUp (>.; 

II Удаление имени 

AddNameNCB.WDeleteName(OurName) ; 
errno - AddNameNCB.Error(); 

} 

// Функция для проверки кода ошибки 
int Error(void) {return errno;} 

// Функция для передачи по каналу 

void Send(char ‘ReceiveBuffer, unsigned BufferSize) { 

// Устанавливаем адрес и длину буфера 

AddNameNCB.SetBuffer(ReceiveBuffer , BufferSize); 

// Передаем данные по каналу с ожиданием 
AddNameNCB.WSend( ); 


"ДИАЛОГ-К 
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void main(void) { 

1 1 Ваш клиент с именем "NETBIOS Client" . 

NETBIOS_SESSION_CLIENT Client ( "NETBIOS Client*)'} 

// Проверяем, были ли ошибки на этапе инициализации клиента, 
if ( Client . Error ()) { 

printf ("Ошибка »02.2X\n", Client.Error())} • 
return; 

} 

printf(" Инициализация завершена .\n"); 

// Перелаем сообщение серверу по созданному каналу. Канал был 
// создан при работе конструктора класса NETBIOS_SESSION_CLIENT . 
Client.Send ("Привет от клиента NETBIOS!", 512)) 

> 

Файл netbios.hpp (листинг 24) содержит все необходимые определения для 
программ, работающих с каналами NETBIOS: 

// ----------—- 

// Листинг 24. Классы для работы с NETBIOS 
// . ■ 

// Файл netbios.hpp 

// г ‘ и' ■ . 

// (С) A. Frolov, 1993 

//-...--===---- 

// Команды NETBIOS 

// Команды для работы с именами 

«define NB_WAddName 0x30 

«define NB_AddName ОхЬО 

«define NB_WAddGroupName 0x36 ' 

♦define NB_AddGroupName 0xb6 
«define NB_WDeleteName 0x31 
♦define NB_DeleteName ОхЫ 
// Команды для передачи датаграмм 
♦define NB_WSendDatagram 0x20 
♦define NB_SendDatagram 0xa0 
♦define NB_WSendBroadcastDatagram 0x22 
♦ define NB_SendBroadcastDatagram 0xa2 ' 

// Команды для приема датаграмм 
♦define NB_WReceiveDatagram 0x21. 

♦define NB_ReceiveDatagram Oxal 
♦define NB_WReceiveBroadcastDatagram 0x23 
♦define NB_ReceiveBroadcastDatagram 0xa3 
// Команды для работы с каналами 
♦define NB_WCall 0x10 
♦define NB_Call 0x90 
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♦define NB_WListen Oxll 
♦define NB_Listeh 0x91 
♦define NB_WHangUp 0x12 
♦define NB_HangUp 0x92 

II Команды для передачи данных по ханалу 

♦define NB_WSend 0x14 

♦define NB_Send 0x94 

♦define NB_WSendNoAck 0x71 

♦define NB_SendNoAck Oxfl 

♦define NB_WChainSend 0x17 

♦define NB_ChainSend 0x97 

♦define NB_WChainSendNoAck 0x72 

♦define NB_ChainSendNoAck 0xf2 

// Команды для приема данных по каналу 

♦define NB_WReceive 0x15 

♦define NB_Receive 0x95 

♦define NB_WReceiveAny 0x16 

♦define NB_ReceiveAny 0x96 

// Прочие команды 

♦define NB_WResetAdapter 0x32 

♦define NB_WCancel 0x35 

♦define NB_WSessionStatus 0x34 

♦define NB_SessionStatus 0xb4 

// Класс NCB для работы с командами NETBIOS 

class NCB { 

// Стандартный блок NCB в формате NETBIOS 
struct _NCB { 

unsigned char Cmd; 

unsigned char CCode; 

unsigned char LocalSessionNumber; 

unsigned char NetworkNameNumber; 

void far ‘Buffer; 

unsigned Size; 

char CallName[16]; 

char OurNaroe[16]; 

unsigned char ReceiveTiroeout; 

unsigned char SendTimeout; 

void interrupt (*PostRoutine)(void); 

unsigned char AdapterNumber; 

unsigned char FinalCCode; 

unsigned char Reserved!14]; 

struct SREGS sregs; 
union REGS regs; 
unsigned errno; 


■ДИАЛОГ-МИФИ' 
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Локальные 


персональных компьютеров 


1 1 Функция для вызова NETBIOS 
void NetBIOS(void) { 

sre9s.es = FP_SEG(Sncb); 
regs.x.bx = FP_0FF(Snob); 
int86x(0x5c, sregs, Sregs, ssregs); 

> 

// Конструктор, расписывает neb нулями 
NCB() { 

memset(&ncb, 0, sizeof(neb)); 
errno - Oj 

> 

// Функция возвращает код ошибки 

int Error(void) {return errno;} 

// Функция для добавления имени 
void WAddName(char ‘name); 

II Функция для удаления имени 

void WDeleteName(char ‘name); 

// Функция для определения номера имени 
unsigned GetNetworkNameNumber ( void ) 

{ return(neb.NetworkNameNumber) ; } 

// Функция для установки адреса и размера буфера 

void SetBuffer(char far *Buf, unsigned BufSize) { 
neb.Buffer = Buf; 
neb.Size - BufSize; 

} 

// Установка в NCB тайм-аута 

void SetRtoSto(int rto, int sto) { 
ncb.ReceiveTimeout * rto; 
ncb.SendTimeout = sto; 

> 

II Установка в neb имени вызываемого партнера 
void SetCallName(char ‘name); 

II Установка в neb имени нашей станции 
void SetOurName(char ‘name); 

11 Прием датаграмм с ожиданием 

void WReceiveDatagram(int NetwrkNameNumber) { 

11 Заполняем поле номера своего имени 

neb.NetworkNameNumber = NetwrkNameNumber; 

// Вызываем NETBIOS 

ncb.Cmd = NB_WReceiveDatagram; 
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NetBios ()l 

) 

// Передача датаграмм с ожиданием 

void WSendDatagram(int NetwrkNameNumber) { 

// Заполняем поле номера своего имени 

ncb.NetworkNameNumber = NetwrkNameNumber; 
ncb.Cmd = NB_WSendDatagram; 

И Вызываем NETBIOS 
NetBIOS!); 

> 

// Создание канала с принимающей стороны 
void WListen(void) { 

ncb.Cmd - NB_WListen; 

NetBios(); 

} 

// Создание канала с передающей стороны 
void HCall(void) { 

ncb.Cmd - NB_WCall; 

NetBios ()l 

) 

// Удаление канала 

void HHangUp!void) { 

ncb.Cmd = NB_WHangUp; 

NetBios(); 

} 

// Прием из канала с ожиданием 
void WReceivefvoid) { 

ncb.Cmd = NB_WReceive; 

NetBios(); 

> 

II Передача в канал с ожиданием 
void «Send(void) { 

ncb.Cmd = NB_WSend; 

NetBiosf); 











Приложение 1 

ФУНКЦИИ IPX 


Функции для работы с сокетами 


IPXOpenSocket - открыть сокет 


На входе: ВХ = 
AL = 


DX = 


ооь. 

Тип сокета: 

00h - короткоживущий; 

FFh - долгоживущий. 

Запрашиваемый номер сокета или OOOOh, если требу¬ 
ется получить динамический номер сокета. 
Примечание. Байты номера сокета находятся в пе¬ 
ревернутом виде. 


На выходе: AL 


DX 


Код завершения: 

00h - сокет открыт; 

FFh - этот сокет уже был открыт раньше; 
FEh - переполнилась таблица сокетов. 
Присвоенный номер сокета. 


IPXCIoseSocket - закрыть сокет 
На входе: ВХ = Olh. 

DX = Номер закрываемого сокета. 
На выходе: Регистры не используются. 


Функции для работы с сетевыми адресами 
IPXGetLocalTaget - получить непосредственный адрес 


На входе: 


На выходе: 


ВХ = 02h. 

ES:SI = Указатель на буфер длиной 12 байт, содержащий полный 

сетевой адрес станции, на которую будет послан пакет. 

ES:DI = Указатель на буфер длиной 6 байт, в который будет запи¬ 
сан непосредственный адрес, т. е. адрес той станции, ко¬ 
торой будет передан пакет. Это может быть адрес моста. 

AL = Код завершения: 

00h - непосредственный адрес был успешно вычислен; 

FAh - непосредственный адрес вычислил, невозможно, так 
как к указанной станции нет ни одного пути доступа по сети. 

СХ = Время пересылки пакета до станции назначения (только 

если AL равен 0) в тиках системного таймера. Тики 
таймера следуют с периодом примерно 1/18 секунды. 
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IPXGetlnternetworkAddress - получить собственный адрес 
На входе: ВХ = 09Ь. „ 

ES.DI = Указатель на буфер длиной 10 байт, в который будет 
записан адрес станции, на которой работает данная 
программа. Адрес состоит из номера сети Network и 
адреса станции в сети Node. 

На выходе: Регистры не используются. 

Прием и передача пакетов 
IPXListenForPacket - принять ІРХ-пакёт 
На входе: ВХ = 04h. 

ES.DI = Указатель на заполненный блок ЕСВ. Необходимо 
заполнить поля: 

ESRAddress; 

Socket; 

FragmentCnt; 

указатели на буферы фрагментов Address; 
размеры фрагментов Size. 

На выходе: Регистры не используются. 

IPXSendPacket - передать ІРХ-пакет 
На входе: ВХ = 03h. 

ES:DI = Указатель на заполненный блок ЕСВ. Необходимо 
заполнить поля: 

ESRAddress; 

Socket; ■ 

ImmAddress; 

FragmentCnt; 

указатели на буферы фрагментов Address; 
размеры фрагментов Size. 

В заголовке пакета IPX необходимо заполнить поля: 
PacketType; 

Dest,Network; 

DestNode; 

Dest Socket 

На выходе: Регистры не ііспользуются. 
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Локальные сети персональных компьютеров 


Другие функции IPX и AES 

IPXDisconnectFromTaget - отключиться от партнера 
На входе: ВХ = OBh. 

ES:SI = Указатель на структуру, содержащую сетевой адрес 
станции: 

struct NetworkAddress { 

unsigned char Network[4]; 
unsigned char Node[6]; 
unsigned char Socket[2]; 


На выходе: Регистры не используются. 

IPXScedulelPXEvent - отложить событие 
На входе: ВХ = 05h. 

АХ = Время задержки в тиках таймера 
ES:SI = Указатель на блок ЕСВ. 

На выходе: Регистры не используются. 

IPXGetIntervalMarker - получить интервальный маркер 
На входе: ВХ = 08h. 

На выходе: АХ = Интервальный маркер. 

IPXCancelEvent - отменить событие 
На входе: ВХ = 06h. 

ES:SI = Указатель на блок ЕСВ. 

На выходе: AL = Код завершения: 

00h - функция выполнена без ошибок; 

F9h - обработка ЕСВ не может быть отменена; 
FFh - указанный ЕСВ не используется. 

IPXRelinquishControl - выделить время драйверу IPX 
На входе: ВХ = ОАЬ. 

На выходе: Регистры не используются. 







Приложение 2 

ФУНКЦИИ SPX 


Инициализация SPX 


SPXChecklnstallation - инициализировать SPX 


На входе: 
На выходе: 


ВХ 

AL 

AL 


ВН 

BL 

СХ 

DX 


10h. 

00h. 

Код завершения: 

00h - SPX не установлен; 

FFh - SPX установлен. 

Верхний (major) номер версии SPX. 

Нижний (minor) номер версии SPX. 

Максимальное количество каналов SPX, поддерживаемых 
драйвером SPX. 

Количество доступных каналов SPX. 


Образование канала связи 


SPXListenForConnection - создать канал с принимающей стороны 


На входе: 


ВХ = 12Ь. 

AL = Счетчик повторов попыток создать канал связи. 

АН = Флаг включения системы периодической проверки связи 
(Watchdog Supervision Required Flag). 

ES:SI = Указатель на блок ЕСВ. 


На выходе: 


Регистры не используются. 


SPXEstablishConnection - создать канал с передающей стороны 
На входе: ВХ — 1 lh 

AL = Счетчик повторов попыток создать канал связи. 

АН = Флаг включения системы периодической проверки связи 
(Watchdog Supervision Required Flag). 

ES.SI = Указатель на блок ЕСВ 


На выходе: AL = Промежуточный код завершения: 

00h - выполняется попытка создать канал; 

FFh - указанный в блоке ЕСВ сокет закрыт; 

FDh - сбойный пакет: либо счетчик фрагментов не 
равен 1, либо размер фрагмента не равен 42; 

EFh - переполнение локальной таблицы номеров 
каналов связи. 

DX Присвоенный номер канала. 


" ДИАЛОГ-МИФИ' 
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Локальные 


персональных компьютеров 


Прием и передача пакетов 

SPXListenForSequencedPacket - принять SPX -пакет 
На входе: ВХ = 17h. 

ES.'SI = Указатель на блок ЕСВ. 

На выходе: Регистры не используются. 


SPXSendSequencedPackett - передать SPX -пакет 


На входе: 


ВХ = 16Ь. 

ES:SI = Указатель на блок ЕСВ 
DX = Номер канала связи. 


На выходе: 


Регистры не используются. 


Разрыв канала связи 
SPXTerminateConnection - закрыть канал 
На входе: ВХ = 13h 

ES:SI = Указатель на блок ЕСВ 
DX = Номер канала связи 


На выходе: 


Регистры не используются. 


SPXAbortConnection • закрыть канал аварийно 
На входе: ВХ = 14h. 

DX = Номер канала связи. 

На выходе: Регистры не используются. 


Проверка состояния канала 


SPXGetConnectionStatus - получить состояние канала 


На входе: 


ВХ = 15Ь. 

DX = Номер канала связи. 

ES:SI = Указатель на буфер размером 44 байта. 


= Код завершения: 

00h - канал активен; 

EEh - указанный канал не существует. 


На выходе: AL 



Приложение 3 

ФУНКЦИИ NETBIOS 

Работа с именами 


NB_WAddName (0x30) - добавить имя 


Поля NCB на входе 

Содержимое 

Cmd 

OurName 

PostRoutine 

AdapterNumber 

0x30 

Добавляемое имя 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, Т-второй 


Поля NCB на выходе 

Содержимое 

NetworkNameNumber 

CCode 

FinalCCode 

Присвоенный номер имени 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB_AddName (ОхВО) 

Команда аналогична предьщущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВО. 


NB WAddGroupName (0x36) - добавить групповое имя 


Поля NCB на входе 

Содержимое 

Cmd 

OurName 

PostRoutine 

AdapterNumber 

0x36 

Добавляемое групповое имя 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

NetworkNameNumber 

CCode 

FinalCCode 

Присвоенный номер имени 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB_AddGroupName (ОхВб) 

Команда аналогична предьщущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВб. 


■ДИАЛОГ-МИФИ' 















148 Локальные сети персональных компьютеров 


NB WDeleteName (0x31) - удалить имя 

Поля NCB на входе 

Содержимое 

Cmd 

OurName 

PostRoutine 

AdapterNumber 

0x31 

Удаляемое имя 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB.DeleteName (ОхВІ) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхВІ. 


Прием и передача датаграмм 


NB WSendDatagram (0x20) - послать датаграмму 

Поля NCB на входе 

Содержимое 

Cmd 

NetworkN ameN u mber 
CallName 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x20 

Номер, присвоенный при добавлении имени 

Имя станции, которой передаются данные 

Адрес буфера, содержащего передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB_SendDatagram (ОхАО) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхАО. 
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NB_WSendBroadcastDatagram (0x22) - послать датаграмму одновременно 
всем станциям 


Поля NCB на входе Содержимое 

Cmd (к22 ~ 

NetworkNameNumber Номер, присвоенный при добавлении имени 
Buffer Адрес буфера, содержащего передаваемые данные 

Size Размер буфера 

PostRoutine Дальний указатель на POST -программу или нулевое 


значение, если POST -программа не используется 
AdapterNumber _Номер адаптера; 0 - первый адаптер, 1 - второй 


—--—----*- 

Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB_SendBroadcastDatagram (0хА2) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0хА2. 


NB_WReceiveDatagram (0x21) - принять датаграмму 

Поля NCB на входе Содержимое 

Cmd 0x21 : 

NetworkNameNumber Номер, присвоенный при добавлении имени Или OxFF 

Buffer Адрес буфера, содержащего передаваемые данные 

Size Размер буфера 

PostRoutine Дальний указатель на POST -программу или нулевое 


значение, если POST -программа не используется 
AdapterNumber Номер адаптера; 0 - первый адаптер, 1 - второй 



Поля NCB на выходе 

Содержимое 

CallName 

Size 

CCode 

FinalCCode 

Имя станции, от которой получена датаграмма 

Размер принятого блока данных 

Промежуточный код завершения команды 
Окончательный код завершения команды 


NB_ReceiveDatagram (ОхАІ) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхАІ. 


'ДИАЛОГ-МИФИ ■ 
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NB_WReceiveBroadcastDatagram (0x23) - принять датаграмму, посланную 
одновременно всем станциям в сети 

Поля NCB на входе 

Содержимое 

Cmd 

NetworkNameNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x23 

Номер, присвоенный при добавлении имени или OxFF 
Адрес буфера, содержащего передаваемые данные 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CallName 

Size 

CCode 

FinalCCode 

Имя станции, от которой получена датаграмма 

Размер принятого блока данных 

Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_ReceiveBroadcastDatagram (0xA3) 

Команда аналогична предьщущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение ОхАЗ. 

Работа с каналами 

NB_WCaIl (0x10) - 

создать канал с передающей стороны 

Поля NCB на входе 

Содержимое 

Cmd 

CallName 

OurName 

ReceiveTimeout 

SendTimeout 

PostRoutine 

AdapterNumber 

0x10 

Имя, с которым устанавливается канал 

Имя станции, создающей канал 

Время ожидания приема, в 1/2 с 

Время ожидания передачи, в 1/2 с 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

LocalSessionNumber 

CCode 

FinalCCode 

Присвоенный номер канала 

Промежуточный код завершения команды 
Окончательный код завершения команды 
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NB_CaIl (0x90) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x90. 


NB^WListen (0x11) ■ 

■ создать канал с принимающей стороны 

Поля NCB на входе 

Содержимое 

Cmd 

CallName 

OurName 

ReceiveTimeout 

SendTimeout 

PostRoutine 

AdapterNumber 

0x11 ---— 

Имя, с которым устанавливается канал. Если в первый 
байт имени записать символ канал будет 

установлен с любой вызывающей станцией 

Имя станции, создающей канал с принимающей стороны 
Время ожидания приема, в 1/2 с 

Время ожидания передачи, в 1/2 с 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер. 1 - втооой 

Поля NCB на выходе 

Содержимое 

LocalSessionNumber 

Присвоенным номер канала 

CallName 

В это поле записывается имя вызвавшей станции, если 
при установлении канала бьио указано имя 

CCode 

Промежуточный код завершения команды 

FinalCCode 

Окончательный код завершения команды 


NB_Listen (0x91) 


Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x91. 


NB WHangUp (0x12) - закрыть канал 


Поля NCB на входе 

Содержимое ' 

Cmd 

LocalSessionNumber 

PostRoutine 

AdapterNumber 

0x12 , --‘“■“ J - 

Номер закрываемого канала 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - втооой 

Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 

Окончательный код завершения команды 
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NB_HangUp (0x92) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x92. 

NB_WSessionStatus (0x34) - получить состояние канала 


Название поля 

Назначение поля 

NameNumber 

SessionCount 

DatagramsOutstanding 

ReceiveAnyoutstanding 

Номер имени канала 

Количество каналов 

Количество выданных команд на прием датаграмм 
Количество вьщанных команд на прием командой 
NB_ReceiveAny 

Session 

Массив структур, описывающих каждый канал в 
отдельности 

LocalSessionNumber 

State 

Номер канала 

Состояние канала: 

1 - ожидание завершения команды NBJListen; 

2 - ожидание завершения команды NB_Call; 

3 - канал установлен; 

4 - ожидание завершения команды NB_HangUp; 

5 - команда NB_HangUp завершила свое вы¬ 

LocalName 

RemoteName 

ReceiveCount 

полнение; 

6 - канал закрыт с ошибкой. 

Имя локальной станции 

Имя удаленной станции 

Количество ожидающих завершения команд 

SendCount 

NB_Receive 

Количество ожидающих завершения команд NB Send 


Поля NCB на входе 

Содержимое 

Cmd 

Buffer 

0x34 

Дальний адрес буфера для приема информации о 
состоянии каналов 

Size 

OurNames 

Размер буфера 

Имя канала, для которого необходимо получить 
информацию о состоянии. В качестве имени можно 

PostRoutine 

указывать "*" 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

AdapterNumber 

Номер адаптера; 0 - первый адаптер, 1 - второй 
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Поля NCB на выходе 

Содержимое 

Size 

CCode 

FinalCCode 

Размер заполненной части буфера 

Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_SessionStatus (0xB4) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
оез ожидания и в поле Cmd необходимо записать значение 0хВ4. 

Прием и передача данных через каналы 

NB WSend (0x14) ■ 

■ передать данные через канал 

Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

ОхЫ --- 

Номер используемого канала 

Указатель на буфер, содержащий передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 

Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_Send (0x94) 


Команда аналогична предьщущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x94. 

NB_WSendNoAck (0x71) - передать данные через канал без подтверждения 

Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x71 '- 

Номер используемого канала 

Указатель на буфер, содержащий передаваемые данные 
Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер. 1 - второй 
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Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_SendNoAck (Oxfa) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение OxFl . 

NB_WChainSend (0x17) - передать данные через канал, используя сцеп¬ 
ленные буферы 

Поля NCB на входе 

Содержимое 

Cmd 

0x17 

LocalSessionNumber 

Buffer 

Size 

CallName 

PostRoutine 

AdapterNumber 

Номер используемого канала 

Указатель на первый буфер, содержащий передава¬ 
емые данные 

Размер первого буфера 

Первые два байта содержат размер второго буфера, 
следующие четыре байта - дальний адрес второго 
буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_ChainSend (0x97) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x97. 

NB_WChainSendNoAck (0x72) - передать данные через канал, используя 
сцепленные буферы без подтверждения 

Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

0x72 

Номер используемого канала 

Указатель на первый буфер, содержащий передава¬ 
емые данные 

Размер первого буфера 
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CallName 

PostRoutine 

AdapterNumber 

Первые два байта содержат размер второго буфера, 
следующие четыре байта - дальний адрес второго буфера 
Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 

Поля NCB на выходе 

Содержимое 

CCode 

FinalCCode 

Промежуточный код завершения команды 

Окончательный код завершения команды 

NB_ChainSendNoAck (0xF2) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0xF2. 

NB WReceive (0x15) 

- принять данные через канал 

Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

Buffer 

Size 

PostRoutine 

AdapterNumber 

0x15 

Номер используемого канала 

Указатель на буфер, используемый для записи при¬ 
нятьи данных 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 

Поля NCB на выходе 

Содержимое 

Size 

CCode 

FinalCCode 

Количество принятьи и записанных в буфер байт данных 

Промежуточный код завершения команды 

Окончательный код завершения команды 

NB_Receive (0x95) 


Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x95. 

NBJWReceiveAny (0x16) - принять данные через канал от любого имени 

Поля NCB на входе 

Содержимое 

Cmd 

NetworkNameNumber 

Buffer 

0x16 ---- 

Номер имени или OxFF 

Указатель на буфер, используемый для записи при¬ 
нятьи данных 
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Size 

PostRoutine 

AdapterNumber 

Размер буфера 

Дальний указатель на POST -программу или нулевое 
значение, если POST -программа не используется 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

Size 

NetworkNameNumber 

CCode 

FinalCCode 

Количество принятых и записанных в буфер байт данных 

Номер имени станции, от которой пришли данные 
Промежуточный код завершения команды 
Окончательный код завершения команды 

NB_ReceiveAny (0x96) 

Команда аналогична предыдущей, за исключением того, что она выполняется 
без ожидания и в поле Cmd необходимо записать значение 0x96. 


Другие команды 

NB_WResetAdapter (0x32) - сбросить сетевой адаптер 


Поля NCB на входе 

Содержимое 

Cmd 

LocalSessionNumber 

NetworkNameNumber 

AdapterNumber 

0x32 

Максимальное количество каналов или 0 для 
использования значения по умолчанию 

Максимальное количество блоков NCB или 0 для 
использования значения по умолчанию 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

FinalCCode 

Окончательный код завершения команды 

NBJVCancel (0x35) 

- отменить команду 

Поля NCB на входе 

Содержимое 

Cmd 

Buffer 

AdapterNumber 

0x35 

Указатель на блок NCB, для которого отменяется 
команда 

Номер адаптера; 0 - первый адаптер, 1 - второй 


Поля NCB на выходе 

Содержимое 

FinalCCode 

Окончательный код завершения команды 




























Приложение 4 

РАБОТА С IPX, SPX И NETBIOS 
В СРЕДЕ MS WINDOWS 


Создание программ, специально предназначенных для работы в среде 
Microsoft Windows, не является предметом обсуждения в данной книге. Однако 
мы сделаем несколько замечаний относительно использования протоколов IPX, 
SPX и NETBIOS в программах, работающих в среде Microsoft Windows версии 
3.1 и Microsoft Windows for Workgroups версии 3.1. 

Работа в среде Microsoft Windows версии 3.1 

Все резидентные программы, имеющие отношение к сетевой оболочке Novell 
NetWare, необходимо загружать до запуска Windows. Это относится и к эмуля¬ 
тору протокола NETBIOS. Если вы запустите эти программы из виртуальной 
машины MS-DOS, работающей в среде Windows, рано или поздно произойдет 
аварийное завершение Windows. 

Е-«Л аша пр0грамма Р аботает в среде MS-DOS с протоколами IPX, SPX или 
NETBIOS она без всяких изменений будет работать и на виртуальной машине 
Windows. Вам только надо проследить, чтобы все резидентные программы и 
эмулятор NETBIOS загружались до запуска Windows. 

Если же вы желаете создать полноценное приложение для Windows, работа¬ 
ющее с сетевыми протоколами, вам следует иметь в виду, что для всех этих 
протоколов необходимо указывать адреса управляющих блоков и буферов, 
расположенные в первом мегабайте основной оперативной памяти. Кроме того! 
из приложений Windows, работающих в защищенном режиме, вы не можете 
непосредственно вызывать драйвер IPX/SPX или прерывание NETBIOS, так как 
эти интерфейсы рассчитаны на вызов из реального режима. 

Вы можете выйти из такого затруднительного положения, если воспользуе¬ 
тесь интерфейсом с защищенным режимом DPMI (DOS Protected Mode 
Interface), описанным нами в томе "Библиотеки системного проіраммиста", по¬ 
священном использованию защищенного режима. 

В рамках интерфейса DPMI есть функции, позволяющие из программы, ра¬ 
ботающей в защищенном режиме, вызывать прерывания или функции, предназна¬ 
ченные для работы в реальном режиме. Кроме того, в API Windows есть функции, 
с помощью которых вы можете заказать для программы защищенного режима 
буферы, расположенные в первом мегабайте основной оперативной памяти. 


Работа в среде Microsoft Windows for Workgroups версии 3.1 
Замечания, сделанные выше, относятся и к Microsoft Windows for Workgroups 
версии 3.1. Однако эта операционная система может и не поддерживать протоколы 
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IPX/SPX. С помощью приложения Control Panel вы можете подключить или 
отключить поддержку сети Novell NetWare и протоколов IPX/SPX. 

Если поддержка Novell NetWare не используется, вам доступен протокол 
NETBIOS, который является "родным" протоколом для Windows for Workgroups. 

Мы проверили работу NETBIOS через интерфейс прерывания INT 2Ah при 
работе в виртуальной машине MS-DOS. Сразу после загрузки сетевых драйве¬ 
ров Windows for Workgroups интерфейс NETBIOS недоступен. Однако в среде 
виртуальной машины MS-DOS этот интерфейс появляется. 

Приведем два фрагмента системы "клиент-сервер", проверенной нами при 
работе в Windows for Workgroups. Вы сможете найти полные исходные тексты на 
дискете, которая продается вместе с книгой (эти исходные тексты почти полностью 
повторяют тексты системы "клиент-сервер", работающей с датаграммами). 

Первый фрагмент проверяет присутствие интерфейса NETBIOS: 

// Проверяем наличие интерфейса NETBIOS 
regs.h.ah = 0; 
int86 (0x2а, Sregs , Sregs); 

if(regs.h.ah -- 0) { 
errno=0xff; 

} 

Второй фрагмент предназначен для вызова NETBIOS через прерывание 
INT 2Ah: 

// Функция для вызова NETBIOS 
void NetBios ( void) { 

sregs.es = FP_SEG(Sncb); 
regs.x.bx = FP_OFF(Sncb); 
regs.h.ah = 0x4; 
regs.h.al = Oxl; 

int86x(0x2a, Sregs, Sregs, -esTegs); 
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